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1 . 0 INTRODUCTION 

Identification of Document 


This is the LET-EC&M Software Maintenance Manual for the NASA 
Advanced Communications Technology Satellite (ACTS) High Burst Rate 

Ij? NA?i Ua ci?? T ®rminal (HBR-LET) . This document complies with 
t . . NASA Software Management and Assurance Program (SMAP) 

. the Informati °n System Life-Cycle and Documentation 
Standards, Release 4.3. This manual is one component of the 
Control and Performance Monitor (C&PM) Subsystem document series. 


1«2 8 cope of Document 


Software 


The LET-EC&M 
developers who 
software resides 
utilizing Concurrent's 


Maintenance Manual was compiled for 
know FORTRAN VII computer language. All HBR-LET 
on a Concurrent Corporation 3205 minicomputer 
... _ . . OS/32 operating system. Familiarity with 

the Concurrent minicomputer's capabilities is beneficial. 


Familiarity with the various types of instruments and devices used 
by the LET, and a working knowledge of their operation is required 
to use this document. 


1*3 Purpose of Document 

This document provides information about the development 

?S^M^ 1 o n '<: 4 - and maintenance of the Experiment Control and Monitor 
(EC&M) Software. The LET-EC&M Software Maintenance Manual will 
assist programmers with future software modifications and upgrades 
as necessary. Refer to the HBR-LET EC&M User's Guide for 
information concerning the specific operation of the EC&M Software 
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Section 1 - Introduction 

1.4 Document Status and schedule 

Version 1.0 is the first Contractor Report publication of the LET- 

publ i shed J^was Released* ^irf May^ ?^T47=hTfme the HBR-LET was 
fully integrated and tested. 

to the software and are discussed in the program summa 


1.5 Document organization 


Int?odtrcTT„d^e C s 0 c n rib e tS th 0 i f s d^emen? 6 another r^Tdocum^nts? 
i™ ce ® nrovides specific information concerning the 
implementation of the source code and the associated ^ta files. 
Hardware and software dependencies are also discussea. 

Modification aids necessary for future ource 
4 Section 5 describes the adaptations for the sourc 

code Shiie Sections 6 and 7 contain a list of the abbreviations 
and "acronyms used in this document and a i g software 
Finally, Section 8 contains appendices describing th task 
instrument Table, program structure, procedure library and task 
commons 6 in detail. A list of the instruments controlled by the 
EC&M .Software is also provided. 
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2.0 RELATED DOCUMENTATION 

2.1 Parent Document 


None 


2.2 Applicable Documents 

The following instrument manuals and other related documentation 

are referenced herein and pertain to this document. Refer to these 

documents for additional operating procedures. 

1. EIP 545b Microwave Frequency Counter Users Manual , EIP 
Microwave Inc., March 1980. 

2. General Microwave 60 dB Attenuator Controller User's Manual , 
NASA LeRC, Ivansic, W. , 1990. 

3. HBR-LET Acceptance Test Report, IF Noise Unit, NASA LeRC, 
Fujikawa, G. , 1990. 

4. HBR-LET Experiment Control and Monitor Software User's Manual, 
NASA Contractor Report 189160, NASA LeRC, Reinhart, R.C., 
October, 1992. 

5. HP (Hewlett Packard) 117 13 A Attenuator /Switch Driver, 
Operating and Service Manual, Hewlett Packard Company, 1985. 

6. HP 437B Power Meter, Operating and Service Manual, Hewlett 
Packard Company, 1985. 

7. HP 59306A Relay Actuator, Operating and Service Manual, 
Hewlett Packard Company, 1986. 

8. HP 6632 A DC Power Supply, Operating and Service Manual, 
Hewlett Packard Company, 1986. 

9. MENUP Menu Driver documentation, NASA LeRC, Andro, M. , 1987. 
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Section 2 - Related Documentation 


10. SA (Scientific Atlantic) 930 Beacon Receiver Users Manual, 
Scientific Atlanta Inc. 

11. Satellite Ground-Terminal User Simulation, NASA Technical 
Memorandum 100234, NASA LeRC, Shalkhauser, M. J., 

January, 1988. 

12. TERMEB Terminal documentation, NASA LeRC, Walters, J., 1984. 

13. Wavetek 8502 A Peak Power Meters, Operating and Maintenance 
Manual , Wavetek Microwave, Inc., 1989. 


2.3 Information Documents 

Refer to the following documents for additional information on 
computer operation and the various editors. 

1. FORTRAN VII Language System Reference and Users Guide, Perkin 
Elmer Corporation, 1983. 

2. MEDIT User Guide, Perkin Elmer corporation, 1984. 

3. MicroEMACS Reference Manual, Lawrence, D.M. and Straight, B., 
1987. 

4. MTM Primer, Concurrent Computer, 1986. 

5. OS/ 32 EDIT User Guide , Concurrent Computer Corporation, 1986. 

6. OS/32 Supexrvisor Call Reference Manual, Concurrent Computer 
Corporation, 1986. 
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Section 3 - Implementation Details 


3.0 IMPLEMENTATION DETAILS 

3.1 Specific Data Representations and Formats 

The LET-EC&M software system comprises three independent programs. 
The Instrument Definition, Sequence Definition, and Sequence 
Execution programs are designed to create and to execute a wide 
variety of HBR-LET experiments. Multiple device control, data 
acquisition, instrument monitoring, and bit error rate (BER) 
measurement testing are among the EC&M Software functions 
available. 

There are several data representations that must be observed when 
modifications are made to the EC&M Software. Each program in the 
EC&M Software system creates a data file which stores information 
about the instrument's configuration, sequence commands, or 
instrument data. The format type and corresponding file types are 
discussed. All files referenced in the following sections are 
located in the Control and Performance Monitor Software Account 
(CPMSA) or in a private user account. 


3.1.1 Instrument Definition File 

The first component of the EC&M Software, the Instrument Definition 
Software (IDS) , enables a user to define the instrumentation that 
will be used within an experiment. The IDS also allows the user to 
provide the instrument's initial configuration and control 
parameters that are required by the EC&M Software. 

This component creates the Instrument Definition File (formerly 
reffered to as the Test Definition File or TDF) . All data input 
using the IDS is saved to the TDF in an array format, according to 
the defined instrument. Each instrument occupies one column of 
data within the array. Instrument parameters are saved in various 
rows within the column and are described in detail in Appendix I of 
the EC&M Software User's Guide. TDF files are saved in a binary 
format with a record length of 256. These files can reside in any 
private account but must have the filename extension TDF. 
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Section 3 - Implementation Details 
3.1.2 Sequence Definition File 

The sequence of commands that will carry out the desired experiment 
are defined in the second component of the EC&M Software, the 
Sequence Definition Software (SDS) . Sequence commands are 
available to control both the instrumentation used in the 
experiment and in sequence execution. Sequence commands are 
described in detail in Section 6 of the EC&M Software User's Guide. 


Commands defined using the SDS are saved to the Sequence Definition 
File in an array format similar to the TDF file. . Each sequence 
command is stored in a separate column with its required parameters 
in various rows within the column. The Sequence Definition Array 
(SDA) is also saved in a binary format with a record length of 256. 
SDA files can reside in any private account, but must have the 
filename extension SDA. 


3.1.3 Data Acquisition File 

The Sequence Execution Software (SES) executes the predefined 
sequence while performing data acquisition of all instruments 
included in the test. Instrument output readings and errors 
messages are displayed to the user's terminal during sequence 
execution. 

Data gathered during sequence execution is stored to a file with 
each individual measurement time stamped for future reference and 
analysis. The name of the data file created by the SES has the 
same name as the corresponding TDF and SDA files, but with the 
extension DAT. The DAT file is stored in a binary format with a 
record length of 512. One can view sequence data files using the 
C&PM Post Processing Software. 
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3.1.4 Instrument File 

An ASCII data file named INSTRMTS . LET stores the information for 
the Instrument Table used in the EC&M Software. This file contains 
a list of the instruments currently available to the HBR-LET , also 
listed in Appendix B. Each instrument, has a NASA tag number, 
interface type, IEEE 488 bus number, instrument type, label, 
identification, description, and address assigned to it at time of 
publication. Refer to Appendix A for information on the correct 
record entry and column position for each item listed in the data 
file. For more information on the Instrument Table, consult 
Section 4 of the EC&M Software User's Guide. Modifications to the 
Instrument File must not change its current format as required by 
the programs within the EC&M Software system. 


3.2 Operating System Interfaces and Dependencies 

All HBR-LET EC&M Software runs under Concurrent's OS/ 3 2 Operating 
System, Version 8-3.2 or later. The Concurrent computer also has 
a Multi-Terminal Monitor (MTM) which oversees the communication and 
sharing of system resources between the individual users on the 
system. Tasks (programs) are not required to run under the control 
of MTM. The EC&M Software system runs independently of MTM which 
enables multiple tasks to share a common output device. 

Serial communication ports dedicated to the LET project must be 
removed from MTM for proper operation. Failure to remove the ports 
from MTM will result in an inability to initialize the EC&M 
Software. Communication port assignments are listed in Section 
3.4. For instructions on removing a port from MTM, consult the MTM 
Primer or the EC&M Software User's Guide. 


3.3 Support Software and Libraries 

Each component of the EC&M Software has one main program and many 
libraries. Several libraries are also used by the HBR-LET Check- 
Out Software, but are documented here for completeness. A detailed 
description of each program, library, and task common (area of 
computer memory utilized by two or more programs executing 
simultaneously) is provided in Appendix C, Appendix D, and Appendix 
E, respectively. 
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The program technical summary headings contain the program name, 
author names, and short histories of development. Also included in 
the s umm ary is an outline of a program's major functions, the tasK 
commons it shares, the logical units it uses and their device or 
file assignment. A brief explanation of each procedure and its 
corresponding library is provided. 

The library documentation provides additional information on each 
procedure. The library name, author, and history are found at the 
beginning of each summary. A description of the variables passed 
in the procedure calls, their type declaration, and an explanation 
of each procedure function is also provided. A list of the 
programs that use a particular library is also included for cross 
referencing with the program documentation. 

Appendix E describes the task commons used by the Sequence 
Execution control and Sequence Execution display programs. These 
two programs use task commons to share archived data, status flags, 
and the Instrument Definition and Sequence Definition arrays. The 
task common summaries describe the variables, their type 
declarations and a list of programs that use the particular task 
common . 


3.4 Hardware Devices 

All HBR-LET EC&M Software resides on a Concurrent Corporation 3205 
minicomputer and is written in FORTRAN VII. The menu driver 
utilized by the EC&M Software requires a WYSE 50 or compatible 
terminal for best operation. The EC&M Software can also be 
executed from a PC using a modem to communicate with the Concurrent 
minicomputer . 

A printer must be connected to the minicomputer to produce a hard 
copy of the data compiled by the EC&M Software, although it is not 
required for normal operation. It is possible to view all the data 
gathered by the SES using the Post Processing Software from within 
a private account under MTM. 

<j*yo types of interfaces are used to communicate with the 
'instrumentation and devices used in the LET. An IEEE 488 General 
Purpose Interface Bus (GPIB) provides a link to all programmable 
radio frequency (RF) instrumentation. An RS— 232 interface is used 
to communicate with the Digital Ground Terminal (DGT) , Data 
Generator/Data Checker (DG/DC) , and General Microwave (GM) 
Attenuators . 


8 


LET-EC&M Software Maintenance Manual - Version 1.0 



Section 3 - Implementation Details 


Serial communication ports of the Concurrent 3205 minicomputer have 
been assigned dedicated devices (listed in Table 3-1). The DGT, 
DG/DC, and the GM attenuators roust be connected to the assigned 
port for the system to function properly. Failure to do so will 
result in the inability to install or execute the EC&M Software. 
The IEEE 488 bus is connected to the computer via an IEEE 488 
circuit board. 


Comm Port 

Dedicated Device 

Rate/Bits/Parity 

CRT1: 

Beacon Data 

9600/7/even 

CRT2 : 

Menu Display 

9600/7/even 

CRT3 : 

Data Generator/Data Checker 

9600/7/even 

CRT4 : 

Digital Ground Terminal 

9600/7/even 

CRT5 : 

General Microwave Attenuators 

9600/8/none 

CRT6 : 

Protocol Receive Link 

9600/8/none 

CRT7 : 

Protocol Transmit Link 

9600/8/none 


Table 3-1 Concurrent 3205 Communication Port Assignments 


IEEE 488 bus extenders (IOTECH brand) are used with the IEEE 488 
GPIB to communicate with instruments outside the maximum range of 
the standard GPIB. The maximum length of the IEEE 488 bus is about 
20m depending on the number of instruments connected to the bus. 
IOTECH bus extenders are interconnected using an RS-232 cable which 
can carry a signal about 50ft. 

An IOTECH bus expander is also used to allow additional instruments 
to be connected to the same GPIB and extend the maximum length. 
The standard IEEE 488 GPIB can support 14 instruments. The IOTECH 
expander can support an additional 14 instruments, thus a maximum 
of 27 instruments and 1 bus expander can be placed on a single GPIB 
(The IOTECH bus expander counts as an instrument when connected to 
the GPIB) . The Concurrent 3205 currently uses one GPIB; therefore, 
the IOTECH bus expander must be used to accommodate the 
instrumentation used in the HBR-LET system. 
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Section 4 - Modification Aids 

4 . 0 MODIFICATION AIDS 

4.1 Instrument Augmentation 

The EC&M Software accesses an ASCII data file named INSTRMTS.LET 
located in the CPMSA to construct the Instrument Table used in the 
IDS. This file contains a list of the instruments currently 

available to the HBR-LET. The information required for proper 
execution of the EC&M Software is associated with each instrument. 

Users may easily modify the Instrument File at any time to change 
instrument address assignments, add new instruments of an existing 
type, or change other instrument data. To add new types of 

instruments or devices to the Instrument Definition Software, 
follow the procedure outlined in this section. 

1) Assign the instrument or device an unused type number and 

add it to the instrument file as described in the LET- 

EC&M User's Guide. Table 4-1 lists the type numbers and 
their corresponding instruments. 


Type Number 

Instrument 

1 

HP 436A Power Meter 

2 

General Microwave (GM) Attenuator 

3 

HP 11713A Attenuator/ Switch Driver 

4 

Wavetek 8502 Peak Power Meter 

5 

Scientific Atlantic 930 Beacon Receiver 

6 

HP 593 06A Relay Actuator 

7 

EIP 54 5B Frequency Counter 

8 

HP 6632A DC Power Supply 

9 

HP 11713A Switch Driver (Only) 

10 

Data Generator 

11 

Data Checker 

12 

HP Universal Counter 

13 

Keithley Multimeter 

14 

Philips Frequency Counter 

15 

HP Dual Sensor Power Meter 
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I Type Number 

Instrument 

1 16 

HP signal Generator 

17 

Eb/No Calculation 

18 

HP 6624A Power Supply 

19 

HP 437B Power Meter 

20 

GM Power Meter 

- 21 

Digital Ground Terminal 

22 

HP sweep Oscillator 

23 

HP Spectrum Analyzer 

24 

Wiltron Signal Generator 

25 

Compu-motor Indexers 


Table 4-1 Instrument Type Numbers 


2) Add the new instrument's parameters to the user default 

file Ml : DEFAULT. LET/ 111 . Include the additional 

parameters in the Ml : LABELS . LET/lll file, which is used 
with the user default file. The default parameter files 
DEFAULT. LET and LABELS. LET are described in Section 5 of 
this document. 

3) Modify the Instrument Definition Menu Software, 
Ml : TDFLET . MNU/ ill , to include a menu displaying the 
parameters associated with the new instrument or device. 

4) Develop the necessary software to initialize and decode 
the menu that coincides with the new instrument. 
Currently, two subroutines exist for each instrument in 
the TDF software. One subroutine initializes the 
instrument menu with the default parameters and a second 
subroutine decodes the instrument menu into the proper 
locations within the Instrument Array (RINST/INST) . 
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4.2 Sequence Command Expansion 

Seauence commands added to the existing EC&M Software system will 
require modifications to both the Sequence Definition and Sequence 
Execution programs. Both the SDS and SES have modular designs with 
separate subroutines which aids in debugging e J ror ® J*?, J2 

future modifications. To add commands to the SDS and SES, follow 

the steps listed below: 

1) Control numbers specify a group of sequence commands of 
the same type. Assign a sequence control number to the 
new command if it does not fit into an existing category 
listed in Table 4-2. 


Control Number 

Function 

100000 

Executes the specified sequence 
command. Single execution 
statement. 

200000 

Executes the SET UP A LOOP 
sequence command. Single 
execution statement within a 
loop. Sequence commands are 
repeated until an end of loop 
control number is encountered. 

299999 

Executes the END LOOP sequence 
command. Terminates the loop 
and continues the sequence. 

300000 

Executes the CALL A SUBSEQUENCE 
seauence command. 

399998 

Executes the RETURN TO MAIN 
SEQUENCE sequence command. 
Terminates Subsequence execution 
and transfers control back to 
the Main Sequence. 

999997 

Executes the END SEQUENCE 
sequence command. Terminates 
the execution of the main 
sequence . i 


Table 4-2 Sequence Execution Control Numbers 
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Note 


2 ) 


User input label numbers are added to the control 
number for the purpose of GOTO and Check a 
Parameter sequence commands. To avoid overlapping 
control categories as a result of a label number, 
the maximum label number is 99997. 


Assign an unused action number to the sequence command. 
Existing action numbers are listed in Table 4-3. These 
numbers are used to direct the software to execute the 
proper command. 


Action Number 

Action 

21 

Set a Parameter 

60 

Zero Power Meter 

61 

Step a Parameter 

101 

Wait 

102 

Goto Statement 

110 

Check a Parameter 

301 

Start Data Generator 

302 

1 Stop Data Generator 

303 

Stop Data Checker 

311 

Set Data Generator Errors 

313 

Perform BER Measurement 

315 

DGT Command 


Table 4-3 Sequence Command Action Numbers 
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3) Assign the new command a one-to-four character mnemonic 
to assist users in recognizing commands within the 
seguence. The mnemonic is used to identify seguence 
commands in seguence display, printouts, editing, an 
execution. Existing mnemonics are listed in Table 4-4. 


Mnemonic 

Seguence Command 

ATTN 

Set or Step Attenuation 
Parameter 

BCNR 

Set SA Beacon Receiver Parameter 

BER 

Perform BER Measurement 

CKBE 

Check BER Parameter 

CKCU 

Check DC Power Supply Current 
Parameter 

CKEB 

Check Eb/No Parameter 

CKFR 

Check Freguency Parameter 

CKPR 

Check Power Level Parameter 

CKVT 

Check DC Power Supply Voltage 
Parameter 

' CSUB 

Call Subseguence Command 

DGTC 

Diqital Ground Terminal Command 

EBNO 

Set or Step Eb/No Parameter 

ENDL 

End Loop 

FREQ 

Set Freguency Parameter 

GOTO 

Goto Statement 

LOOP 

Set Up a Loop 

NERR 

Set Data Generator Errors 

PSCR 

Step DC Power Supply Current 
Parameter. 

PSVT 

Step DC Power Supply Voltage ji 

Parameter. 

PWCR 

Set DC Power Supply Current 
Parameter. 


14 


LET-ECSM Software Maintenance Manual - Version 1.0 



Section 4 - Modification Aida 


Mnemonic 

Sequence Command 

PWVT 

Set DC Power Supply Voltage 
Parameter. 

SPDC 

Stop Data Checker 

SPDG 

Stop Data Generator 

STDG 

Start Data Generator 

TGSW 

Set Parameter Toggle Switch 
Command 

WAIT 

Wait Command 

WVTK 

Set Wavetek Parameter 

ZERO 

Zero Power Meter 


Table 4-4 Sequence Command Action Mnemonics 


4) Identify the required parameters for the new command and 
add them to the Instrument and Sequence Editor 
Documentation found in the EC&M Software User's Guide. 

5) Develop software to execute the new command. Copy the 
software used in the CTRLLET program to the loop and sub- 
sequence subroutines in the SES. Insure that the new 
command can be executed from within a loop and sub- 
sequence. 
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4.3 Instrument and Sequence Editor 

An Instrument and Sequence editor program enables users to view or 
edit existing instarument and sequence files. Each instrument's 
initial configuration parameters and sequence command parameters 
are described in Appendix I of the HBR-LET EC&M Software User's 
Guide (bound under separate cover) . The guide also includes the 
location of each instrument and sequence parameter within the 
instraument and sequence file respectively. Use the Instrument and 
Sequence Editor for all interaction with the instrument or sequence 
files. Related instrument and sequence files share the same 
filename but have the appropriate extensions described in the HBR- 
LET EC&M User's Guide. 
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5.0 CODE ADAPTATION 

Link File Modifications 


Link files join together one or more object files to create an 
executable task file. For proper operation, several system options 
must be included in the link files of the main programs (TDFLET, 
SDALET , DSPLET , CTRLLET) used in the EC&M Software. A brief 
description of these options follow. Refer to the MTM OS/32 User's 
Manuals for further information on the available link options. 


ACPRIV 


Provides a user task with additional privileges for 
accessing files in private accounts. This option 
is used by all programs in the EC&M Software. 


COMMUNICATE 


CONTROL 


Specifies that the executing task can perform the 
SVC6 intertask communication function. This 
feature is required for sending messages between 
the Sequence Execution and Display Software. 

Specifies that the executing task can perform the 
SVC6 intertask control function. This feature is 
required to enable the Display program to load and 
start the SES. 


Specifies the number of I/O blocks assigned to a 
task. 


Specifies the maximum number of logical units that 
can be assigned by a task. 

Indicates that, if a task executes a SVC1 with bit 
7 of the function code set, the options specified 
by the SVC1 extended option field are to be 
executed. 


5.2 Default Initialization File 


Two data files correspond to the default values assigned to the 
instrument parameters. The user file. Ml: DEFAULT. LET/ 111, is 
designed to be edited by a system operator for modifying existing 
default parameter values. 

The DEFAULT. LET file contains the various instruments and 
instrument parameters used in the EC&M Software. For this 
description, the following definitions are used. Each line of the 
ca ll6d a field or record. Instrument and parameter names 
called field descriptors. Programs within the IDS require that 
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the instrument and parameter names and their locations remain 
unchanged within the field and, therefore, .NOT be altered by 

the user Figure 5-1 illustrates several fields within the 

default parameter file, only a portion of the file introduction is 

shown in the figure. 


I This is the default parameter 

file for the High Burst Rate 

| Link Evaluation Terminal... 


I HP POWER METER 437B 

RANGE 

1.0 

AUTO 

TRIGGER MODE 

3.0 

FREE RUN 

LOW LIMIT 

-100.0 


HIGH LIMIT 

10.0 


CALIBRATION FACTOR 

96.8 


UNITS 

1.0 

dBm 

OUT OF LIMIT ACTION 

1.0 

CONTINUE TEST 

GM ATTENUATOR 

INITIAL ATTENUATION 

25.0 


LOW LIMIT 

10.0 


HIGH LIMIT 

60.0 


UNITS 

1.0 

dB 

OUT OF LIMIT ACTION 

2.0 

HALT TEST 


Figure 5-1 DEFAULT. LET Default File 


Users can modify the value of any record in the file. Either a 
space or comma must appear both before and after the numeri 
value for it to be interpreted by the software. Control characters 
(tabs) are not permitted in the file. The numerical value must be 
the first entry following the field descriptor; its location, 
however, is arbitrary. Comments or any type of user identification 
can be included in the same field following the parameter value if 
there is a space or comma separating the two entries as described. 
Any number of records can separate the field descriptors. These 
records can contain descriptive text or be used to separate 
existing field descriptors. 

Several parameters have default values that correspond to available 
options. Appendix E of the HBR-LET EC&M Software User's Guide 
lists the available option values for each parameter. 
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a° second hS f ile™ at Ml?LABELS^LF:T/?i i the DE ™ ULT ' LET u ^er data file, 

xEE ‘H~“ “~r ' ■s/su-s 

instrument are listen ' ;„ Th P aral » e ters that correspond to the 

ilSSSln? and^arameter ^/mes'^tennFne 

s^£,^LiS£E,cr:s 
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10 

19 HP POWER METER 437B 

13 GM ATTENUATOR 

27 HP ATTENUATOR/ SWITCH DRIVER 
24 WAVETEK PEAK POWER METER 
18 SA BEACON RECEIVER 
21 EIP FREQUENCY COUNTER 

17 HP RELAY ACTUATOR 

18 HP DC POWER SUPPLY 

14 DATA GENERATOR 

16 HP SWITCH DRIVER 

9 

5 RANGE 

12 TRIGGER MODE 

18 CALIBRATION FACTOR 
9 LOW LIMIT 

10 HIGH LIMIT 

6 OFFSET 
5 UNITS 

17 INITIAL FREQUENCY 

19 OUT OF LIMIT ACTION 
5 

9 LOW LIMIT 

10 HIGH LIMIT 


<-10 instruments in the file 
<-Inst num 1, 19 char in name 
<-Inst num 2 , 13 char in name 


<-Inst num 10, 16 char in name 
<-9 parameters for inst num 1 
<— Parro num 1 for inst num 1 
<-Parm num 2 for inst num 1 


<-Parm num 9 for inst num 1 
<-5 parameters for inst num 2 
<-Parm num 1 for inst num 2 
<-Parm num 2 for inst num 2 


Figure 5-2 LABELS. LET Default File 

in Figure 5-2. the first 10 indica tee t ha t th StELS/ETtE 
instruments contained in the data tiie^ ^ ollQWS> Next, the 

number of characters in * ted The number 9 (by itself) 

corresponding parameters METER 437B has the 9 following 

indicates that the HP naTne and number of characters 

parameters. Each parameter eated f or every instrument. The 

in the name. This format is repeatedforevery avoid 

instrument default parameter ^ata file^was^^ P f ^ b ET. 

changing existing software and modified without recompiling 

Instrument parameters canbeadded and of the 

existing software. ‘^rict format restrictions and effect 

software developer due to its requires modification to this 

ITSSSS “for^lhe^PM software manager stating the 
nature of the change . 
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I 

/ 


6.0 abbreviations and acronyms 


proi?ded f fo? e u2er r «^«n«. and aCronyms and their definition is 


abbreviation 

acts 

ASCII 

BER 

C&PM 

CAL 

CPMSA 


DEFINITION 

Advanced Communications Technology 
Satellite ** 

American Standard Code for Information 
Interchange 

bit error rate 

Control and Performance Monitor Software 
Account 

Calibration 

Control and Performance Monitor Software 
Account. 


Dfe/DC 

DGT 

EC&M 

GM 

GMAT 

GPIB 

HBR-LET 

HP 

HPA 

HPPM 

HPSD 

IDS 


data generator and data checker 

digital ground terminal 

Experiment Control and Monitor 

General Microwave 

General Microwave Attenuator 

General Purpose Interface Bus 

High Burst Rate Link Evaluation Terminal 

Hewlett Packard 

High Power Amplifier 

Hewlett Packard Power Meter 

Hewlett Packard Attenuator /Switch Driver 
(Used solely as a switch driver) 

Instrument Definition Software 
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IEEE 

Institute of Electrical and Electronic 
Engineers 

LB 

Loopback 

LeRC 

Lewis Research Center 

Mbps 

Megabits per second 

MTM 

Multi-Terminal Monitor 

NASA 

National Aeronautics and Space 
Administration 

PC 

personal computer 

RF 

radio frequency 

SA 

Scientific Atlantic 

SDA 

Sequence Definition Array 

SDS 

Sequence Definition Software 

SES 

Sequence Execution Software 

SMAP 

Software Management and Assurance Program 

TDF 

Test (Instrument) Definition File 

UC 

Upconverter 

WTPM 

Wavetek Peak Power Meter 
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7.0 GLOSSARY 


bit orror rate - the number of bit errors divided by the total 
number of bits received. Bit errors are determined by the data 
checker after comparing the received bit stream with that produced 
by the data generator. 

data generator — produces a pseudorandom data source which 
simulates a transmitting user. 

data checker - outputs the number of bits received and the number 
of bit errors. 

ground terminal - transmits and receives bursted 110.592 
and 221.184 Mbps serial minimum shift keying signals. - 

Link Evaluation Terminal - ground station that provides a LeRC- 
ACTS-LeRC communication link with transmission rates of 110.592 and 
221.184 Mbps. The LET will be used to demonstrate adaptive uplink 
power control through various experiments. 
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Appendix A - Instrument Table Definition and Placement 
8.0 APPENDICES 


Appendix A 

Instrument Table Definitions and Placement 


The Instrument Table contains the following entries; NASA tag 
number, address or CRT number, interface type, IEEE 488 interface 
bus n umb er, type number, label, id, and an instrument description. 


NASA TAG: NASA tag number affixed to the instrument. 

Entry roust be six characters or less. 
(Numerical and alphanumeric characters are 
permitted) . 


ADDR/CRT: IEEE 488 address. For instruments using an 

RS-232 interface, this field contains the 
communication port number. There cannot exist 
two instruments on the same bus extender , same 
bus type, with the same address. 


Interface type. Valid inputs are "1" for IEEE 
488 or "2" for RS-232. 


IEEE 488 interface bus extender number. Valid 
bus numbers are "0" or "1". Entry is limited 
to one character. Currently, only bus "0" is 
available on the computer system. 


LABEL: The label is a three character name of the 

instrument. The label is taken from the 
suitable subsystem hardware documentation. 

ID . A four-character user-defined name of the 

instrument. The ID is used to remind the user 
of the instrument name in the instrument 
table. 

DESCRIPTION: The name of the instrument. This entry can be 

up to 30 characters in length. 
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Appendix A - Instrument Table Definition and Placement 

Type of instrument as defined in Table A-l. 
New type numbers can be added as necessary, 
provided no two different instruments share 
the same number. Type number can consist of 
up to four characters. 


Type 

Instrument 

1 

HP Power Meter 436A 

2 

GM Attenuator Controller 

3 

HP 11713A Atten/Switch Driver 

4 

Wavetek Peak Power Meter 

5 

SA 930 Beacon Receiver 

6 

HP 59306A Relay Actuator 

7 

EIP 54 5B Frequency Counter 

8 

HP 6632A DC Power Supply 

9 

HP Switch Driver 

10 

Data Generator 

11 

Data Checker 

19 

HP Power Meter 437B 

21 

Digital Ground Terminal 


Table A-l Instrument Type Definitions 


Each entry in the table has been given an assigned location within 
the file for formatting purposes. Figure A-l depicts a portion of 
the Instrument Table used at the time of this publication. At the 
top of the table is the column number where each entry begins and 
ends. (Leading zeros are shown as place holders only.) Column 
numbers are shown for this reference only and are not displayed in 
the actual data file. 
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Appendix A - Instrument Table Definition and Placement 

The first entry of the data file contains the number of instruments 
currently in the file and is limited to four characters. The 

remainder of the first line contains the name of the file * ? 

short file description. Record two contains column headers of each 
entry. Instrument descriptions must begin in the third row. 


1 2 3 4 5 6 

1234567890123456789012345678901234567890123456789012345678901234 



0005 K 

nasa tj 

G88833 

G50340 

071649 

183198 

183196 


ADDR 

BUS 

EXT 

TYPE 

LABEL 

ID 

0001 

1 

0 

04 

PM1 

WTPM 

0002 

1 

0 

09 

B37 

HPSD 

0003 

1 

0 

19 

N20 

HPPM 

10 

2 

0 

2 

A1 

GMAT 

21 

2 

0 

2 

B2 

GMAT 


Instruments available to the HBR-LET 
DESCRIPTION 

Wavetek Peak Power Meter 
HP Switch Driver 
HP Power Meter 437B 
GM Attenuator 
GM Attenuator 


Figure A-l Instrument File Definition 


The GM Attenuator controllers are controlled using both an address 
and a channel. A method of encoding the address and channel has 
been developed. Use the address listed in Table A-2 that 
corresponds to the correct attenuator address and channel. 


ADDR 

Channel 

Address 

10 

A j 

0 

11 

A 

1 

20 

B 

0 

21 

B 

1 


Table A-2 GM Attenuator Address Codes 
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Appendix B 

Experiment Control and Monitor Software Instrumentation 

Each instrument presently defined in the HBR-LET is listed in 
Table B-l. The address associated with each instrument has been 
predefined, but can be changed if desired. The devices that are 
connected to the Concurrent 3205 via RS-232 links have a 
dedicated communication port within the EC&M Software System. 
Abbreviations for the subsystem names used within the table are 
listed in Section 6. 


Table B-l 

Instrument 

Identification 

1 

Instrument 

Tag Number 

Name 

Subsystem 

— 

Addr 

WAVETEK 8502 PEAK POWER 
METER 

G88833 

PM1 

HPA 

01 

HP 117 13A SWITCH DRIVER 

G50340 

B37 

HPA 

02 

HP 437B POWER METER 

071649 

N20 

Receiver 

03 

HP 437B POWER METER 

071646 

L16 

Calibration (CAL) 

04 

HP 11713A ATTEN/SWITCH 
DRIVER 

068280 

N6 

Receiver 

05 

HP 11713A ATTEN/SWITCH 
DRIVER 

068281 

N12 

Receiver 

06 

HP 11713A ATTEN/SWITCH 
DRIVER 

068275 

R12 

Receiver 

07 

WAVETEK 8502 PEAK POWER 
METER 

TBD 

PM2 

HPA 

08 

HP 663 2 A POWER SUPPLY 

071580 

PIN 

HPA 

09 

HP 593 06A RELAY ACTUATOR 

071535 

Cl 

Calibration 

10 

HP 437B POWER METER 

003612 

C26 

Calibration 

11 

HP 437B POWER METER 

G88647 

C27 

Calibration 

12 

HP 437B POWER METER 

071643 

U21 

Calibration 

13 

HP 437B POWER METER 

071645 

Rll 

Loopback (LB) 

14 

HP 117 13A ATTEN/SWITCH 
| DRIVER 

068276 

U13 

Loopback 

15 
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Table B-l 

Instrument 

Identification 


Instrument 


Name 

Subsystem 


HP 117 13A ATTEN/ SWITCH 
DRIVER 

068274 

L6 

Loopback 


HP 437B POWER METER 

071647 

U16 

Loopback 

17 

EIP 54 5B FREQUENCY 
COUNTER 

071557 

C9 

Receiver /LB /CAL 

18 

EIP 54 5B FREQUENCY 
| COUNTER 

071556 

R9 

Receiver /LB /CAL 

19 

HP 11713A ATTEN/ SWITCH 
DRIVER 

068277 

TBD 

Monitor 

20 

HP 11713A ATTEN/SWITCH 
DRIVER 

068278 

U4 

Monitor 

21 

HP 11713A ATTEN/SWITCH 
DRIVER 

068279 

U12 

Monitor 

22 

SA 930 BEACON RECEIVER 

G90028 

SA1 

Receiver 


GM ATTENUATOR 
CONTROLLERS 

183198 

GAO 

Loopback/ 

Upconverter 


GM ATTENUATOR 
CONTROLLERS 

183192 

GA1 

Loopback/ 

Upconverter 

■ 

GM ATTENUATOR 
CONTROLLERS 

183191 

GBO 

Loopback/ 

Upconverter 

B, 0 

GM ATTENUATOR 
CONTROLLERS 

183196 

GB1 

Loopback/ 

Upconverter 

B,1 

DATA GENERATOR 

277172 

DG 

BER 

CRT 3 

DATA CHECKER 

277170 

DC 

BER 

CRT3 

DIGITAL GROUND TERMINAL 

704905 

DGT 

DGT/BER 

CRT 4 


Table B-l Instrument Identification 
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Appendix C - Program Descriptions 


Appendix C 


Experiment Control and Monitor Software Program Descriptions 


Source code for each program in the Experiment Control and 
Monitor Software System can be found in the CPMSA. The summaries 
provide an overview of the major functions and use of each 
program. The task commons and libraries referenced by each 
program are documented in Appendix C and Appendix D, 
respectively. 
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Program Name 

Author 

History 


Description 


Task Common 


Ml : CTRLLET. FTN/111 

Richard C. Reinhart / Analex Corporation 
Written December, 1990 

Original Sequence Execution control program written 
for SITE by Ike Kramarchuk and Elaine Daugherty / 
NASA, Digital Technology Branch, 1984 


This program executes the sequence commands defined 
in the Sequence Definition Software. Each sequence 
command has one or more subroutines associated with 
it to execute the command. The modular software 
design enables additional commands to be added 
without changing existing code. 


Available commands include: 
Set a Parameter 
Start Data Generator 
Stop Data Checker 
DGT Command 
Execute Sub-Sequence 
Perform BER Measurement 
Set Data Generator Errors 


Step a Parameter 
Stop Data Generator 
Wait 
Goto 

Set up a Loop 
Check a Parameter 
Zero Power Meter 


Ml : INSTRCOM. IMG/111 

Contains both the Instrument Definition and 
Sequence Definition arrays used throughout the 
Instrument Definition, Sequence Definition and 
Sequence Execution programs. Also includes the 
variable STORE used for writing the header to the 
data file created by the Sequence Execution 
Software. 


Ml : DSPCTRL . COM/ 111 

Contains information about the logical units used 
by both the Display and Sequence Execution 
Programs. Other variables contained within this 
task common include logical variables used as flags 
for the Data Generator, executing Sub-Sequences, 
and performing BER measurements. 
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listed g in a Table t c a i SigninentS USed in the P ro 9 ram CTRLLET are 


I Logical 
1 Unit 

Assignment 

Form 

Access 

Record 

Length 

I 9 

DGT Command File 

Formatted 

Sequential 

80 

I 10 

GM Attenuator 

Formatted 

Sequential 

80 

11 

M1:SEQ. LOG/111 

Formatted 

Sequential 

80 

12 

DGT 

Formatted 

Sequential 

80 

13 

DAT filename 

Binary 

Direct 

512 

14 

MlrSEQ. LOG/111 

Formatted 

Sequential 

80 

16 

DG/DC 

Formatted 

Sequential 

80 


Table C-l Sequence Execution Control Logical Unit Assignments 


Table C-2 lists the procedures called by the program CTRLLET. A 
short description of each procedure and the library where it 
resides is provided. 


Procedure 

Description 

Library 

ENABLE 

establishes the necessary data 
structures to allow a specified 
task trap to be handled by a user 
written trap handling FORTRAN 
subroutine 

RTL 

ERR 

logs command execution errors to 
a file and clears the IEEE 
interface bus 

CTRLLET 

EXECL 

determines which sequence command 
to execute, calls the appropriate 
subroutines, and calls the data 
acquisition subroutine before 
each command is executed 

EXECLET 

EXIT 

allows the calling task to 
terminate its own execution 

RTL 

I CLEAR 

clears the IEEE interface bus 

GENERLIB 
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Procedure 

Description 

Library 

INIT 

initializes a program's real-time 
data structures prior to enabling 
any task trap 

RTL 

SNDMSG 

allows a foreground task to send 
a message to another foreground 
task 

RTL 

SUBSEQ 

executes commands within a sub- 
sequence in a manner similar to 
the main control program 

CTRLLIB2 

SUB 3 

a task trap occurs whenever a 
message is sent from a task via a 
SNDMSG call, causing a user 
written trap handling subroutine 
to receive the message 

RTL 

SYSIO 

performs I/O functions on a level 
comparable to assembly 

RTL 

WAIT 

suspends task execution for a 
specified amount of time 

RTL 


Table C-2 Sequence Execution Control Program Procedures 
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Libraries: 


Ml : ATSETM2 . OBJ/ 111 
Ml : BERDGT . OBJ /111 
Ml : CTRLLIB1 . OBJ/ 111 
Ml : CTRLLIB2 . OBJ /111 
Ml : DATALET . OBJ /111 
Ml : DECDATA . OBJ/ 111 
Ml : DGDCLIB . OBJ/ 111 
Ml : DGTLIB . OBJ/ 111 
Ml : DSPLIB1 . OBJ/111 
Ml : DSPLIB2 . OBJ/ 111 
Ml : EBNZERO . OBJ /111 
Ml : EXECLET . OBJ /111 
Ml : GENERLIB . OBJ/ 111 
Ml : GMLIB . OBJ /111 
M1:GRTL15. OBJ/111 
Ml : INSETUP . OBJ /111 
MllPIN. OBJ/111 
Ml : TERMEB . OBJ /111 
Ml : TDFLIB . OBJ /111 
M1:SA1SEC. OBJ/111 

RTL - Concurrent FORTRAN VII Run-Time Library 
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Program Name M1:DSPLET.FTN/111 

Author Richard C. Reinhart / Analex Corporation 

History Written December, 1990 

Original TDF program written for SITE by Ike 
Kramarchuk and Elaine Daugherty, 1984 / NASA, 

Digital Technology Branch 

Description This program displays the current status or output 
reading of all instruments defined for a particular 
experiment. In addition, it loads and starts the 
control program of the Sequence Execution Software. 
All warning and error messages accrued during 
sequence execution are displayed to the user 
terminal . 

Task Common Ml : INSTRCOM. IMG/ 111 

Contains both the Instrument Definition and 
Sequence Definition arrays used throughout the 
Instrument Definition, Sequence Definition and 
Sequence Execution programs. Also includes the 
variable STORE used for writing the header to the 
data file created by the Sequence Execution 
Software . 
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The logical unit assignments used in the program DSPLET are 
listed in Table c-3. 


Logical 

Unit 

Assignment 

Form 

Access 

Record 

Length 

1 

TDF filename 

Binary 

Direct 

256 

7 

Ml: CTRL. TSK/ 111 

N/A 

N/A 

N/A 

8 

Ml: CTRL. LOG/ 111 

Formatted 

Sequential 

80 

9 

DAT filename 

Binary 

Direct 

512 

10 

GM Attenuator 

Formatted 

Sequential 

80 

12 

DGT 

Formatted 

Sequential 

80 

13 

DAT filename 

Binary 

Direct 

512 

13 

SDA filename 

Binary 

Direct 

512 

14 

CRTX: 

Menu 

N/A 

80 

16 

DG/DC 

Formatted 

Sequential 

80 

17 

DSP filename 

Formatted 

Index 

96 


Table C— 3 Sequence Execution Display Logical Unit Assignments 


Note: CRTX: refers to the communication port 

dedicated to menu display. Ml: DSPLET. MNU/ 111 
is the DSPLET menu software. 


Table C-4 lists the procedures called by the program DSPLET. A 
short description of each procedure and the library where it 
resides is provided. 


| Procedure 

Description 

Library 

ABORT 

allows a FORTRAN program to 
terminate the exec.ution of a 
foreground task 

RTL 

ALLINIT 

initializes all the instruments 
defined for a particular 
experiment 

DSPLIB2 
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Procedure 

Description 

Library 

ALLLOCAL 

places all the instruments 
defined for an experiment in 
local mode, returning control of 
the instrument to the front panel 
keys 

DSPLIB3 

ALLREMOTE 

places all the instruments 
defined for an experiment in 
remote mode, placing the 
instrument under computer control 

DSPLIB1 

ASSEMB 

allows the DSPLET program to 
initialize variables from a CSS 
file. Used to initialize the 
DEBUG flags. 

ASSEMB 

BITDECODE 

decodes the variable BIT^POS to 
determine if an out of lTmit 
condition exist 

DSPLIB3 

DISPLAY 

outputs the sequence definition 
array to either the user terminal 
or the line printer at the user's 
discretion 

DSPLIB3 

ENABLE 

establishes the necessary data 
structures to allow a specified 
task trap to be handled by a user 
written trap handling FORTRAN 
subroutine 

RTL 

EXIT 

allows the calling task to 
terminate its own execution 

RTL 

HOLD 

suspends execution of a task 
until released 

RTL 

ILBYTE 

loads a single byte from one 
argument to another 

RTL 

INIT 

initializes a program's real-time 
data structures prior to enabling 
any task trap 

RTL 

INQUIRE 

inquires as to whether or not a 
file exists 

RTL 

IOERR 

outputs error messages to the 
system console when an I/O error 
occurs as a result of a SYSIO 

RTL 
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Procedure 

Description 

Library 

ISBYTE 

stores a single byte from one 
argument to another 

RTL 

LOAD 

allows a program to load a second 
program into memory 

RTL 

MENUF 

menu driver which permits user 
I/O from any user terminal 
defined in row 1, col 31 of the 
menu software 

MENUP2 

OPENW 

allows a calling program to 
assign one of its logical units 
to a file or device 

RTL 

PCUR 

positions the curser to a 
specified location on the user 
terminal 

MENUP2 

RELSE 

releases a suspended task 

RTL 

SENDLU 

causes the device or file 
assigned to the specified lu of 
the calling task to be reassigned 
to the specified lu of the 
directed task. The lu of the 
sending task is closed 

RTL 

SNDMSG 

allows a foreground task to send 
a message to another foreground 
task 

RTL 

START 

allows a program to start another 
program that has been loaded into 
memory 

RTL 

SUB 3 

a task trap occurs whenever a 
message is sent from a task via a 
SNDMSG call, causing a user 
written trap handling subroutine 
to receive the message 

RTL 

SUB9 

a task trap is enabled whenever a 
subtask has a state change, 
causing a user written trap 
handling subroutine to be 
executed 

RTL 

SYSIO 

performs I/O functions on a level 
comparable to assembly 

RTL 
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Procedure 

Description 

Library 

TERMEB 

performs terminal I/O functions 
such as clear terminal, beep, 
lock and unlock keyboard, etc 

TERMEB 

WAIT 

suspends task execution for a 
specified amount of time 

RTL 


Table 04 Sequence Execution Display Program Procedures 


Libraries: M1:ASSEMB.0BJ/111 

Ml : ATSETM2 . OBJ /111 
Ml : BERDGT . OBJ /111 
Ml : CTRLLIB1 . OBJ/ 111 
M 1 : CTRLLI B2. OBJ/111 
Ml : DGDCLIB . OBJ /111 
Ml : DGTLIB . OBJ /111 
Ml : DSPLIB1 . OBJ /111 
Ml:DSPLIB2 .OBJ/111 
Ml:DSPLIB3. OBJ/111 
Ml : GENERLIB . OBJ /111 
Ml : GMLIB. OBJ /111 
Ml : GRTL15 . OBJ /111 
Ml : INSETUP . OBJ /111 
• Ml : MENUP2 . OBJ / S 
Ml:TDFLIB. OBJ/111 
Ml : TERMEB . OBJ /111 

RTL - Concurrent FORTRAN VII Run-Time Library 
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Program Name Ml : SDALET . FTN /111 

History Wri«en Cor P orati °" 

«« * - A 

Digital Technology Branch ' ' 


Description 


This program enables a user to define fhe 

will°ISe n t S th3t th€ Se< 3 uence Execution Software 

experiment ° ° Ut a com P uter controlled 

t# Sub-sequences as well as Main 

LET-e 2 S%«?? created using this software. The 

descfioti nSf ? rS U ® er ' s Guide Provides individual 
° f ® ach se{ 3 u ence command. The purpose 
file u h ■ P k °^ raiTI bo bu ^d the sequence definition 
fif? Jf hlCh i! utilized by the Sequence Execution 

c?eated e bef™ lnst ™ ent definition file must be 
software executing the sequence definition 


Task Common Ml : INSTRCOM. IMG/ ill 


Contains both the Instrument Definition and 
Sequence Definition arrays used throughout the 
Instrument Definition, Sequence Definition and 
Sequence Execution programs. Also includes the 
variabie STORE used for writing the SeaSe? to the 

Software 6 Created by the Sequence Execution 
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The logical unit assignments used in the program SDALET are 
listed in Table C— 5. 


Assignment 


TDF filename 


SDA filename 


INSTRMTS . LET Formatted 


System Console Formatted 


CRTX: Menu 




14 

Table C-5 


5 Sequence Definition Logical Unit Assignments 

N ° te: dedicated* 5 to 

is the SDALET menu software. 


22 ? ^ h n e ifa^tfon 9 ”"ihe A 

library where it resides. 


Procedure 

Description 

Library 

BERMEASURE 

defines the number of BER 
measurements at a particular 
Eb/No 

SDALIB3 

CALLSUB 

defines the name of the sub- 
sequence to execute during 
sequence execution 

SDALIB3 

CHECKPARM 

specifies the instrument to | 

check, high and low limits, and I 

label numbers to goto if reading 
is out of limit 

SDALIB3 

DISPLAY 

outputs the sequence definition 
array to either the user terminal 
or the line printer at the user s 
discretion - — 

SDALET 
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Procedure 

Description 

Library 

| ENDSEQ 

verifies that all Check a 
Parameter and GOTO sequence 
command argument label numbers 
exist. Issues error messages 
when required label numbers are 
not defined 

SDALET 

II EXIT 

allows a calling task to 
terminate its own execution 

RTL 

GOTOST 

specifies the target label number 
within a GOTO sequence command 

SDALIB3 

LABELIT 

converts a user input label 
number to a sequence control 
number for the sequence execution 
software 

SDALIB3 

MENUF 

menu driver which permits user 
I/O from any user terminal 
defined in row 1, col 31 of menu 
software 

MENUP 

PM ZERO 

specifies the power meter to 
receive the zero function during 
sequence execution 

SDALIB2 

SDADGTCOMM 

defines the name of the DGT file 
to execute during sequence 
execution 

SDALIB4 

SETERROR 

allows user to specify the number 
of errors to put in data stream 
output by the Data Generator 

SDALIB3 

SETLOOP 

sets up a loop within a main or 
sub sequence 

SDALIB3 

SETPARM 

sets a specified parameter to a 
user defined value. Instrument 
label and parameter value must be 
input 

SDALIB2 

STARTDG 

command to start the Data 
Generator 

SDALIB2 

STEPPARM 

steps a specified parameter by a 
user defined amount. Instrument 
label and step parameter value 
must be input 

SDALIB2 
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|j 

Procedure 

Description 

Library 

STOPDC 

command to stop the Data Checker 

SDALIB2 

STOPDG 

command to stop the Data 
Generator 

SDALIB2 

TERMEB 

performs terminal I/O functions 
such as clear terminal, beep, 
lock and unlock keyboard, etc 

TERMEB 

WAIT 

suspends task execution for a 
specified amount of time 

RTL 

WAITT 

suspends sequence execution for a 
specified amount of time 

SDALIB2 


Table C-6 Sequence Definition Program Procedures 


Libraries; M1;BERLIB2.0BJ/111 
Ml : ENCDATA . OBJ /111 
Ml : GENERLIB . OBJ /111 
Ml : MENUP . OBJ / S 
Ml : TERMEB . OBJ / S 
Ml :TDFLIB.OBJ / 111 
Ml : TDFLIB2 . OBJ /111 
Ml : SDALIB2 . OBJ /111 
Ml : SDALIB3 . OBJ /111 
Ml : SDALIB4 . OBJ/ 111 
Ml : SDALIB5 . OBJ /111 

rtl - Concurrent FORTRAN VII Run-Time Library 
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Program Name Ml rTDFLET. FTN/m 
History £2?, en Cor P orati °n 


Description 


?I?^ Pr09 f ain allows a user to define the 
instruments to be used in a sequence. Each 

has requSe^input^whifh 0111 an f , I J? trument Table and 
EC&M So^ware Sser^s Gu?L are ^ 6fined in the LET ' 
program is to bu ??* +£! ? «. he P ur P ose of this 

which is utUized bv bot^ n ?^T nt definitio " file 
and Sequence ExIcutLS sof^re ?^ 6006 Definition 


Task Common Ml: INSTRCOM. IMG/m 


Se^enSJ Defin??? Instruinent Definition and 
sequence Definition arrays used throuahnnt fv, a 

nstrument Definition, Sequence Definition and 

variable STOR^use/f ° 9rai " S ; ■ A1S ° includes the 
data file c?efted h„ ?K siting the header to the 
Software d by the Se< Juence Execution 


The logical unit 
listed in Table 


assignments used in the 
C-7 . 


program TDFLET are 


Logical 

Unit 

Assignment 

Form 

Access 

Record 

Length 

256 

1 

TDF filename 

Binary 

Direct 

8 

LABELS . LET 

Formatted 

Direct 

80 

8 

[ DEFAULT . LET 

I Formatted 

Direct 

80 

10 

INSTRMTS . LET 

Formatted 

Direct 

u V 
80 

11 

System Console 

Formatted 

Sequential 

v U 
80 

14 

CRTX: 

Menu 

n/a 

80 


Table c-7 Instrument Definition Logical Unit Assignments 
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Note: 


CRTX: refers to the communication port 
dedicated to menu display. Ml: TDFLET. MNU/ 111 
is the TDFLET menu software. 


Table C-8 lists the procedures called by the program TDFLET. 
short description of each procedure and the library where it 
resides is provided. 


Procedure 

Description 

Library 

ADDR21 

initializes the switch positions 
of instrument U4 using the 
desired path from input to output 

TDFLIB3 

ADDR22 

initializes the switch positions 
of instrument U12 using the 
desired path from input to output 

TDFLIB3 

CLEARM 

used to reset the menu variables 

GENERLIB 

DECDG 

decodes the DG/DC menu from the 
user terminal into the. proper 
instrument array positions 

TDFLIB2 

DECEIPF 

decodes the EIP Frequency Counter 
menu from the user terminal into 
the proper instrument array 
positions 

TDFLIB2 

DECGMAT 

decodes the GM Attenuator menu 
from the user terminal into the 
proper instrument array positions 

TDFLIB2 

DECHPAT 

decodes the HP Attenuator /Switch 
Driver menu from the user 
terminal into the proper 
instrument array positions 

TDFLIB2 

DECHPPM 

decodes the HP Power Meter menu 
from the user terminal into the 
proper instrument array positions 

TDFLIB2 

DECHPPS 

decodes the HP Power Supply menu 
from the user terminal into the 
proper instrument array positions 

TDFLIB2 

DECHPRA 

decodes the HP Relay Actuator- 
menu from the user terminal into 
the proper instrument array 
positions 

TDFLIB2 
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Procedure 

decsabr 


DECHPSD 
DECWTPM 

EXIT 
INSETUP 

MENUF 

OPTION21 

OPTION22 

TAGCHEK 

TDFDG 
TDFEIPF 


Description 

decodes the SA Beacon Receiver 
menu from the user terminal into 
the proper instrument array 
positions * 

thS HP Switch Dr iver menu 
from the user terminal into the 

prop er instrument array positions 
decodes the Wavetek Peak Power 
into r t£ enU fr ° m * he user terminal 
po5itions Pr ° Per 

allows the calling task to 
terminate i ts own execution 

reads in the default values of 
the instrument parameters from an 
external ASCII file 

??JJ U * driver which permits user 
I/O from any user terminal 
defined in row l, col 31 of the 
menu software 

sets up the option field for 

? 4 * °Ptions contain 

Jio« aV ^ la ? le in P uts and outputs 
Respectively fo r that instrument 

sets up the option field for 
instrument U 12 : Options contain 

J^ la ? le inputs and outputs 
P c J- vely for that instrument 

nn r ih leS that no two instruments 

extender 9 ? 6 bU u extender / and bus 
extender type have the same 

address 

initializes and displays the Data 
Generator/ Data Checker (DG/DC) 
menu t o the user terminal 

initializes and displays the EIP 
Frequency Counter menu to the 
user terminal 


Library 

TDFLIB2 


TDFLIB2 


TDFLIB2 


RTL 


TDFLIB 


MENUP 


TDFLIB 3 


TDFLIB3 


TDFLIB 


TDFLIB 


TDFLIB 
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Procedure 

Description 

Library 

II 

TDFGMAT 

initializes and displays the 
General Microwave Attenuator menu 
to the user terminal 

TDFLIB 

TDFHPAT 

initializes and displays the HP 
Attenuator/ Switch Driver menu to 
the user terminal 

TDFLIB 

TDFHPPM 

initializes and displays the HP 
Power Meter menu to the user 
terminal 

TDFLIB 



TDFHPPS 

initializes and displays the HP 
Power Supply menu to the user 
terminal 

TDFLIB 

TDFHPRA 

initializes and displays the HP 
Relay Actuator menu to the user 
terminal 

TDFLIB 

TDFHPSD 

initializes and displays the HP 
Switch Driver menu to the user 
terminal 

TDFLIB 

TDFSABR 

initializes and displays the 
Scientific Atlantic (SA) Beacon 
Receiver menu to the user 
terminal 

TDFLIB 

TDFWTPM 

initializes and displays the 
Wavetek Peak Power Meter menu to 
the user terminal 

TDFLIB 

TERMEB 

performs terminal I/O functions 
such as clear terminal, beep, 
lock and unlock keyboard, etc 

TERMEB 

WAIT 

suspends task execution for a 
specified amount of time 

RTL 


Table C-8 Instrument Definition Program Procedures 
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Ml : BERLIB2 . OBJ/111 
Ml : GENERLIB . OBJ /111 
Ml : INSETUP . OBJ /111 
Ml : TDFLIB . OBJ /111 
M1:TDFLIB2 .OBJ/lll 
Ml : TDFLIB3 . OBJ/ 111 
Ml : TERMEB . OBJ /111 
Ml:MENUP.OBJ/S 

RTL - Concurrent FORTRAN VII Run-Time Library 
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Appendix D 

Experiment Control and Monitor Software Library Descriptions 


Each library used in the EC&M Software System is located in the 
CPMSA. The library outlines provide a short description of the 
variables passed by the subroutines and an explanation of the 
functions performed by each. The programs that use the 
respective library are listed on the bottom of each outline. 
Appendix C contains a summary of the EC&M Software programs. 
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Author 

History 


Appendix D - ECSM Software Libraries 

Ml : ATSETM 2 . FTN /111 

Written * October^ C ° rp ° rati °” 

Revised November, 1990 <RCR> 

/ r Di £?l, A Z SE ?' Written by Elaine Daugherty 
/ Digital Technology Branch y ^ 


NASA 


Variables used by the subroutines: 


ADDRESS 


ATTN 


IBUS 


ITEMP 


STATUS 


SW 9 


swo 


instrument *address. Variable co "baini„ g the 

value^f a i t n Cn t uIt a fin able oTl™ i < 9 8! he dSSired 

sotwk arasaL-.-sras. 

If lnPUt Variable de Pi ct ing the position 

0 off 

1 on 

of swi?ch R o? input varlable depicting the position 

0 off 

1 on 


SOTROOTTNE MW( ITEftt j^IBUS I, MDRESS , ATTN I , SW9 , SWO , STATUS) 
using the convention; 1 On, 0 off* lons are represented 
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Programs : 


Experiment Control and Monitor Software 
Ml : CTRLLET . FTN /111 


Check-Out Software 
Ml : BER . FTN /111 
Ml : L6 . FTN /111 
Ml : N6 . FTN/111 
Ml : N12 . FTN/ 111 


Ml : MAINCTRL . FTN/ 1 1 1 
Ml :R12 ♦FTN/111 
M1:U13.FTN/111 
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Library Name 

Author 

History 


Ml : BERDGT . FTN /111 

5SS Corporation 

Revised September 21, 1990 Version l.o <RCR> 


Variables used by the subroutines: 


BURSTED jawwj input variable which contains a 

of the desired c“!* ?a?ef ate iS n0t 3 mUltlple 

CONTINUOUS » njIIWRM input variable which contains a 

u , ^ ^ the date rate is an even 

multiple of the desired clock rate. 


RATE 


R110 


R220 


STATUS 
STATUS 1 


If Se E d2i^ed n ^a V ?ate ble C ° ntaini ^ value 

a LOGICAL input/output variable depictina the 

?e™!^i bUrStin9 rate ° f the Oigitll G^Snd 

FALSE’- D DGT i i. Set . f S r 110 Mbps commun ioation. 
FALSE - DOT is set for other than no Mbps comm. 

a LOdCAL input/output variable depictina the 
?erm?nal Sti " 9 ° f the Di ^ ^°unf 

false'. 0 ™ 1 ? set . f ° r 220 “bps communication. 
FALSE DOT is set for other than 220 Mbps comm. 

an INTEGERS output variable used to return the 
execution status of the subroutine. th 

see STATUS. 


SUBROUTINE NOTRAKACQ ( STATUS 1 ) 

Sends the command 'DISABLE BVERF SFVERF TRKINT ' to the 

SUBROUTINE TRAKACQ (STATUS 1) 

Sends the command 'ENABLE BVERF SFVERF TRKINT' to the DOT 


SUBROUTINE RESETMUX ( STATUS 1 ) 

Sends the 'START RESET SYNC' and 
the DGT. 


'RXSYNC PCA' 


commands to 
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SUBROUTINE NEWACQ (STATUS) 

Acquires the status of the DGT. 

SUBROUTINE DGTCLOCK (BURSTED , CONTINUOUS, STATUS) 

Sets the appropriate clock rate of the DGT depending on 
the current burst rate. 

SUBROUTINE MODEMRATE (RATE, R2 20, R1 10, STATUS) 

Sets the user desired bursting rate of the DGT. Valid 
options are 220 Mbps and 110 Mbps. 


Programs : 


Experiment Control and Monitor Software 
Ml : DSPLET . FTN/ 11 1 
Ml : CTRLLET . FTN /111 


Check-Out Software 
Ml : BER . FTN /111 
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Libraries 


Library Name 

Author 

History 


Ml : BERLIB2 . FTN /111 
Richard C. Reinhart / Analex 
Revised September 21 , 1990 


Corporation 
Version 1.0 


<RCR> 


Variables used by the subroutines: 


IRATE 


variable depict ina ( t S f I ' U a B f R) /OUtput (OPERATE) 
data °" d 


Table D — 1 


Data Rate 
Mbps 

IRATE 

ITYPE 1 

1.25 

0 

” 

0 

5.00 

3 

0 

12.50 

5 

0 

13.824 

5 

8 

25.00 

8 

0 


8 

8 

IlHBHBl 

1 9 

0 

27.648 (89) 

9 

8 

50.00 

12 

0 

55.296 

12 

8 


13 

0 


13 

8 


15 

0 

BK5H 

15 

—2— j 


Data Rate and Type Definitions in the BERLIB2 Library 
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ITYPE an INTEGER* 4 input (SETUPBER) /output (TYPERATE) 

variable depicting the data type. Data rates and 
data types are listed in Table D-l. 

0 Represents a bursted mode of operation. Data 
rate is not a multiple of the clock rate. 

8 Represents continuous mode of operation. Data 
rate is an even multiple of the clock rate. 

IN a CHARACTER* 2 4 input (TYPERATE) /output (SETUPBER) 

array containing the input fields for the current 
menu. 


SUBROUTINE TYPERATE ( IRATE, ITYPE, IN) 

Converts the user selected menu inputs into the data type 
and data rate variables ITYPE and IRATE respectively. 

SUBROUTINE SETUPBER (IRATE, ITYPE, IN) 

Converts the variables ITYPE and IRATE into data type and 
data rate menu inputs for display to the user terminal. 


Programs : 


Experiment Control and Monitor Software 
Ml : TDFLET . FTN / 1 1 1 


Check-Out Software 
Ml : BER . FTN /111 
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Library Name 

Author 

History 


Ml : CTRLLIB1 . FTN /111 

Written Rei ? hart / Analex Corporation 
written December 1990 


Variables used by the subroutines: 

ADDR an INTEGERS input 

instrument address. 

ADDRESS see ADDR 


variable containing the 


COUNT 1 

CURRENT 

DBUG 


FREQ 


IBUS 


ID 


IUNIT 


KBUS 

LENGTH 

MSG 


an INTEGER*4 output variable whose value indicates 
the Master Division Alarm bit in error. lncUcates 

a REAL* 4 output variable containing the outnut 
current of the HP DC Power Supply. P 

an INTEGER *4 input variable once used to outDut 

TM st . at ® men . ts during the software development 

a iflue oft 15 n0t USSd Within the subroutine Sni 
a value of zero is appropriate. 

?eaT£ 4 t Tli? cr/tir 9 the **•*“"* 

?nterfacf ;L in n P u U m be V r arlable containi "9 «,e IEEE 488 

the”^^?^* 5 variable containing the name of 

instrument 3 9 3 m6SSage to a Particular 

an INTEGER*4 output variable depicting the 

Wavetek^Peak ^ 

1 Watts 

2 dBm 

see IBUS 

an INTEGER* 4 input variable containing the number 
an instrument. alned ln message string ' sent <=° 

an INTEGERM input/output array used as a message 
buffer containing the ASCII command sent to an 

instrument or device. Also contains the instrument 
response when one is transmitted. instrument 
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OPTION an INTEGER* 4 input variable representing the 
channel of the Wavetek Peak Power Meter to read. 

RMSG a REAL* 4 input array containing the instrument 

parameter values to send to an instrument. 

SINGLE a REAL* 4 output variable containing a single 

reading of the output power of the Wavetek Peak 
Power Meter . 

STATUS an INTEGER*4 output variable used to return the 
execution status of the subroutine. 

STBIT an INTEGER*4 output variable containing the error 
code returned by the Wavetek Peak Power Meter , if 
an error is present. Consult the Wavetek User / s 
manual for a detailed description of the error 
codes. 

STREN a REAL* 4 output variable containing the signal 

strength of the SA Beacon Receiver. 

TEST a INTEGER*4 input array containing the Master 

Division Alarm Status bits returned from the SA 
Beacon Receiver. 

TRIG an INTEGER*4 input variable representing the 

trigger mode of the HP Power Meter. 

VOLTS a REAL *4 output variable containing the output 

voltage of the HP DC Power Supply. 


SUBROUTINE FCREAD ( DBUG , IBUS , ADDRESS , FREQ , STATUS ) 

Similar to FCREAD2 , with the addition of the hold active 
command. This routine was developed when errors occurred 
with the IEEE 488 interface bus. 

SUBROUTINE FCREAD 2 (DBUG, IBUS , ADDRESS , FREQ, STATUS) 

Author: Elaine Daugherty 

Obtains the current frequency reading displayed on the EIP 
Frequency Counter. This subroutine is no longer used by the 
EC&M Software. 

SUBROUTINE HPREAD ( DBUG , IBUS , ADDR , STATUS , TRIG , RMSG ) 

Obtains the current output power of the HP 437B Power Meter. 
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SUBROUTINE WTREAD ( ADD^, IBUSJBUG , OPTION , STATUS , SINGLE, 

Se^r? S ae%moN n v a ri^i k P ° Wer ° f the Wavetek Paa * Power 
mode rea?erTl^te V d a ^„ a “aw: r D!I POndin9 the ° hannal and 


OPTION 

Channel 

Mode 

2 

A 

CW 

4 

B 

CW 

6 

A 

PEAK 

8 

B 

PEAK 


Table D-2 Wavetek Peak Power Meter Channel/Mode Definition 


SUBROUTINE PSREAD (ADDR, IBUS , DBUG 
Obtains the output voltage and 
Power Supply. 


, STATUS , VOLTS , CURRENT) 
current from the HP 6632A DC 


SUBROUTINE ERRCHECK (ADDR , LENGTH , DBUG, KBUS STATUS RMSG) 

£?oJ e ret h u e rned at , U f S bit ° f tte HP Metefanl 'decodes the 

Subroutine occurs. called from within HPREAD 


SUBROUTINE SASTATUS ( DBUG , IBUS, ADDR , STATUS ) 

BoJoor, 1 ? 6 S . tatUS ° f the MASTER DIVISION ALARMS of the SA 
“ 1V ? r- Correct alar ”> bit setting is user defined 
Tabli D-3™ PlaCS at tlm ® ° f this Publication are listed iA 
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Bit 

Number 

Correct 

Value 

Description 

0 

0 

No hardware fault 
present in Tuner 
lock alarm 

1 

0 

Demod slot 1 locked 

2 

1 

Demod slot 2 not 
locked 

3 

0 

Carrier above 
threshold 

4 

0 

No hardware fault 
present in 
Frequency 
Synthesizer 

5 

1 

Internal reference 

6 

0 

No hardware fault 
present in 2nd LO 
Lock Alarm 

7 

1 

Internal LO 


Table D-3 Master Division Alarm Status Codes 


SUBROUTINE SACHECK (DBUG , IBUS , STATUS , TEST, C0UNT1) 

Compares the MASTER DIVISION ALARM status returned from the 
SA Beacon Receiver with the user defined configuration and 
returns the appropriate status to the SASTATUS subroutine. 

SUBROUTINE GETPOWER ( DBUG , I BUS , ADDR , STATUS , STREN ) 

Obtains the beacon signal strength from the SA Beacon 
Receiver. 

SUBROUTINE SASEND (ADDR , LENGTH , DBUG , KBUS , STATUS , MSG , ID) 

Sends and receives ASCII messages to/from the SA Beacon 
Receiver. 


Programs : 

Experiment Control and Monitor Software 
Ml : CTRLLET . FTN /111 
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Library Name 

Author 

History 


Appendix D - EC&M Software Libraries 

Ml : CTRLLIB2 . FTN /111 

Written SicS^S,i A " aleX C ° rporati °" 


Variables used by the subroutines: 


ADDR instrument address f Ut Variabl * 
CHANNEL 


the 


3H INTEGER* 4 input vari'ahio 

desired channel for the Wavetek S f ntlng the 

command. Table D -4 list* fho Power Meter 

channels available on the Wavetrt Peak 'povefSete?* 


Table D -4 
CRT 


Option 

Number 

Channel 

Mode I 

1 

A+B 

CW I 

2 

A 

CW | 

3 

A+B 

PEAK 1 

4 

B 

CW 

5 

A 

graph ] 

6 

A 

PEAK 

7 

B 

graph I 

8 

B 

PEAK 1 

9 

A 

marker 

10 

B 

marker 

11 

A 

PULSE I 

12 

B 

PULSE 1 


Wavetek Peak Power Meter Channel/Mode Definitions 


unit N tsigned 1 to U thI a DGT ble containin 9 the logical 
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DBUG 

EDGE 

FILENAME 
IBUS 
LOG 2 


Software Libraries 

an INTEGER*4 input variable once used to output 
debug statements during the software development. 
This variable is not used within the subroutine and 
a value of zero is appropriate. 

an INTEGER*4 input variable representing either the 
rising or falling edge of the Wavetek Peak Power 

Meter . 

1 Rising Edge 

2 Falling Edge 

a CHARACTER*20 input variable containing the name 
of the DGT Command File. 

an INTEGER*4 input variable containing the IEEE 488 
interface bus number. 

an INTEGER*4 input variable corresponding to the 
logical unit assigned to an output device such as 
the terminal or file. 
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?n *f TEGERM ln Put variable representing the D392XOP 
funetiGn parameter of the Wavetek Peak Power Meter P 

• Bea ?°™ Receiver. Parameters for the 
respective instruments are listed in Table D- 5 . 


| OPTION 

Wavetek 

SA Beacon Receiver 

0 

Frequency 

Frequency 

1 

Reference Delay 

2nd LO VFO 

1 2 

Curser Delay 

Video Attenuation 

1 3 

Start Delay 

Sig Strength Offset 

4 

Window Delay 

Carrier Indicator 

5 

Reference Delay 

Sig Strength Slone 

6 

Pulse Rise Time Start 

N/A 

7 

Pulse Rise time End 

N/A 

8 

Pulse Fall Time Start 

N/A 

9 

Pulse Fall Time End 

N/A 

10 

Pulse Width Time Start 

N/A 

11 

Pulse Width Time End 

N/A 

12 

Marker 1 Placement 

N/A 

13 

Marker 2 Placement 

N/A 

14 

Marker 3 Placement 

N/A 

15 

Marker 4 Placement 

N/A 


Table D-5 


R110 


R220 


Wavetek Peak Power Meter/SA Beacon Receiver Parameter 

Options 


(TRm? It ^fr tP * Ut ^ ariable whose logical state 
^(TRUE) represents the current modem rate of the 


variable whose logical state 
^(TRUE) represents the current modem rate of the 
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RMSG a REAL* 4 input array containing the instrument 

parameter values to send to an instrument. 

SEQN an INTEGER* 4 input variable containing the current 

sequence command number. 

STATUS an INTEGER*4 output variable that used to return 
the execution status of the subroutine. 

VALUE a REAL*4 input variable containing the value of the 
parameter specified by the OPTION variable. 

SUBROUTINE CHEKRATE (STATUS , R220 , R110 , L0G2 ) 

Queries the DGT to determine the current modem rate of the 
DGT. Sets logical flags indicating its status (220 Mbps 
/110 Mbps) . Other routines use the modem rate flags to 
determine when to change the modem rate. 

SUBROUTINE DGTFILE (FILENAME, CRT, STATUS) 

Reads DGT commands from an ASCII text file and sequentially 
transmits each command to the DGT. Commands are transmitted 
until an end of file is reached or when an error is 
encountered. If an error is returned from the DGT, command 
transmission is halted and an error message is returned to 
the user terminal. 

SUBROUTINE PPMSINGLE ( IBUS , ADDR , OPTION , CHANNEL , EDGE , 

VALUE, STATUS) 

Sends a single command to the Wavetek Peak Power Meter. 
Instrument command is determined by the OPTION variable. 

SUBROUTINE SABRSET (DBUG, IBUS, ADDR, STATUS, OPTION, RMSG) 

Sends a single command to the SA Beacon Receiver. 
Instrument command is determined by the OPTION variable. 

SUBROUTINE SUBSEQ ( DBUG , SEQN , STATUS ) 

Executes the sequence commands from a sub-sequence. The 
code in this subroutine is similar to that in the 
CTRLLET.FTN program. Nested sub-sequences, and loops are 
not permitted within a sub-sequence. 


Programs : 


Experiment Control and Monitor Software 
Ml : CTRLLET . FTN /111 
Ml : DSPLET . FTN /111 
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History 
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Ml : DATALET . FTN /111 

Written "De^^V”* 16 * C °™ io „ 


Variables used by the subroutines: 




INDEX 

IREC 

STAT 


segience E number! >Ut Variable containing the current 

an INTEGER* 4 input variable specifying the curr^nf 
record number of the data acquisition file. 

an XNTEGER*4 output variable used to return the 
execution status of the subroutine. return the 


S Tco°u U ir 1 e s E d D /t? L /T (ERR - SL0T ' ™DEX, IREC, STAT) 
se~1. ^ The°V aC ? lnstrument defined for a particular 

cSanr?s\«cSte“^^ 

L P S°o^e B rffi S ed 9U a^er ST’ 2&2 

for ths particular 3 slTuence 11 . tte'lata *££ 

the variable € BUF 2 ^using 1 ^bitf let”? commlnd^" 2 SaV6d in 


Programs : 


Control and Monitor 
Ml : CTRLLET . FTN /111 


Software 
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Manual - Version l.o 


63 


Appendix D - EC&M Software Libraries 
Library Name M1:DECDATA.FTN/111 

Author Richard C. Reinhart / Analex Corporation 

History Written December 1990 


Variables used by the subroutines: 

IRATE an INTEGER* 4 input variable specifying the user 
date rate as listed in Table D-6. 


Data Rate 
Mbps 

IRATE 

ITYPE 

1.25 

0 

0 

5.00 

3 

0 

12.500 

5 

0 

13.824 

5 

8 

25.000 

8 

0 

27.648(88) 

8 

8 

27.648(09) 

9 

0 

27.648(89) 

9 

8 

50.000 

12 

0 

55.296 

12 

8 

100.000 

13 

0 

110.592 

13 

8 

200.000 

15 

0 

221.184 

15 

8 _ 


Table D-6 Data Rate and Type Definitions in the DECDATA Library 


ITYPE an INTEGER* 4 input variable specifying the data 
type, listed in Table D-6. 

0 Represents bursted mode of operation. Data rate is 

not an integer multiple of the modem rate. 

8 Represents continuous mode of operation. Data rate 

is an integer multiple of the modem rate. 
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RATE a REAL* 4 output variable whose value is the data 

rate in Mbps determined by the data rate and data 
type variables IRATE and ITYPE respectively. 

SUBROUTINE DECDATA ( IRATE , ITYPE , RATE) 

Converts the data rate and data type variables into a 
numerical value equal to the data rate in Mbps specified by 
the user. 


Programs : 


Experiment Control and Monitor Software 
Ml : CTRLLET . FTN/ 111 
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Library Name 

Author 

History 

Variables used 
ISTSP 

IDGC 

IDGCN 

ISTAT 


ISTAT1 

IDEST 


Software Libraries 
Ml : DGDCLIB . FTN/ 111 

Elaine Daugherty / NASA Digital Technology Branch 
Revised September 21, 1990 Version 1.0 <RCR> 


by the subroutines: 

an INTEGER* 4 input variable depicting the command 
that is sent to the Data Generator or Data Checker. 

1 - START 

2 - STOP 

an INTEGER* 4 input variable depicting which device 
is to receive the command specified by the ISTSP 
variable. 

1 - DG 

2 - DC 

3 - DC BER only 

an INTEGER* 4 input variable containing the Data 
Generator or Data Checker number 

an INTEGER*4 input variable containing the status 
returned from the Data Generator or Data Checker. 

0 - ok, no error 

1 - request denied (DG) 

2 - time out (DG) 

95 - couldn't start or stop DG 

96 - not 'ACK' response from DG/DC to STOP message 

97 - illegal DG/DC 

98 - invalid response from DG/DC; contained in 

99 - invalid request 

an INTEGER* 4 output variable. See error 98 above. 
ISTAT I STAT 1 / START ISTAT1/ST0P 

0 who (hex) 0 

<> 0 error word response 

an INTEGER* 4 input variable containing the 
destination of the Data Generator data. The LET 
contains one Data Checker for data destination. 
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IRATE 
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an INTEGER*4 input variable containing the 
rate listed in Table D-7. 


data 


Data Rate 
Mbps 

IRATE 

IDATATYP 

1.25 

0 

0 

5.00 

3 

0 

12.500 

5 

0 1 

13.824 

5 

8 

25.000 

8 

0 

27.648 (88) 

8 

8 

27.648(09) 

^ 9 

0 

27.648(89) 

9 

8 

50.000 

12 

0 

55.296 

12 

8 

100.000 

13 

0 

110.592 

13 

8 

200.000 

15 

0 

221.184 

15 

8 


Table D-7 Data Rate and Type Definitions in the DGDCLIB Library 


IDATATYP an INTEGER* 4 input variable containing the data 
type listed in Table D-7. 

0 Represents a bursted mode of operation. Data 
rate is not a multiple of the clock rate. 

® Represents a continuous mode of operation. 
Data rate is an even multiple of the clock 
rate. 

^ an INTEGER*4 input variable containing the logical 

unit assigned to the 6809 port. 
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an INTEGER* 4 output variable depicting which 
command is issuing a response. 

1 - START status message 

2 - STOP status message 

3 - STATUS check message (DG or DC) 

INPUTP an INTEGER* 4 output array containing the ASCII 
status message received from the DG/DC. 

wrds a DOUBLE PRECISION output variable containing the 

number of words read from the Data Checker. 

XERR a DOUBLE PRECISION output variable containing the 

number of errors read by the Data Checker. 

BER a DOUBLE PRECISION output variable containing the 

kit error rate read from the Data Checker. 

Formula used to determine the BER: 

BER * WRDS*64 / XERR 

I err an INTEGER* 4 input variable containing the number 

of errors to send to the Data Checker. 

0 < I ERR < 99 

IDG see IDGCN . 


SUBROUTINE STSPDGC (ISTSP , IDGC , IDGCN , ISTAT, ISTAT1 , IDEST, 

IRATE , IDATATYP , LU ) 

Starts or stops the Data Generator or Data Checker. 

SUBROUTINE STATCHCK (ISTSP , INPUTP , !STAT, ISTATl) 

Decodes the status returned from the 6809 controller. 
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and obtains the BER data from the Data Checker. ' 

SUBROUTINE SENDERR(IDG, IERR, ISTAT, ISTAT1, LU) 

Sends a user defined number of errors to the Data Generator. 


Programs : 


Control and Monitor Software 
Ml : CTRLLET . FTN /111 
Ml : DSPLET. FTN/ 111 


Check-Out Software 
Ml : BER . FTN /111 
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Library Name 

Author 

History 


Ml:DGTLIB.FTN/lll 

Richard C. Reinhart / Analex 

Written September 21, 1990 


Corporation 
Version 1.0 


Variables used by the subroutines: 


BUFF 

BUFFI 

COUNT 

DBUG 


MSG 


STATUS 


a CHARACTER* 8 0 output variable containing the ASCII 
string returned by the 68000 microprocessor. 

see BUFF. 

The number of characters in the ASCII string sent 
to the 68000 microprocessor. 

an INTEGER* 4 input variable once used to output 
debug statements during the software develops ent. 
This variable is not used within the subroutine and 
a value of zero is appropriate. 

an INTEGER*4 input/output array used as a message 
buffer containing the ASCII command sent to an 
instrument or device. Also contains the instrument 
response when one is transmitted. 

an INTEGER* 4 output variable used to return the 
execution status of the subroutine or the status of 
the system. 


SUBROUTINE DGTMSG (DBUG , MSG , COUNT, BUFF, STATUS) 

Sends an ASCII string to the 68000 microprocessor. 

SUBROUTINE DGTSTAT (DBUG , TEST, BUFFI , STATUS) 

obtains the status of the Digital Ground Terminal. 


Programs : 


Experiment Control and Monitor Software 
Ml : CTRLLET . FTN /111 
Ml : DSPLET . FTN /111 


Check-out Software 
Ml : BER . FTN /111 
Ml : DGT. FTN/ 111 
Ml : MAINCTRL . FTN /111 
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Library Name 

Author 

History 


Ml : DGTLIB2 . FTN/lll 

Richard C. Reinhart / Analex Corporation 

September 21, 1990 Version l.o <rcr> 
Revised December, 1990 version 1.0a <RCR> 


Variables used by the subroutines: 

DAY 3 an INTEGERM input variable that contains the dav 

DL^? m m ° nth - that the MAINCT RL Check-Out Software 
was installed. This variable is used in 
the DGT.TSK Check-out Software program. 

OBUG an INTEGERM input variable once used to outnut 

TM“V ta \ e r ntS during the software development 

riair/^tert ^ 

FILENAME CTER *20JLnput .variable containing the name 

FILENAME 3 a CH ARA CT ER * 1 9 input variable that contain* fh a 
name of the DGT error log fill. contains the 

GBUFF a CHARACTER*8 0 output variable containing the error 
messages generated by the DGT. 

a LOGICAL input variable that is used as a flaa to 
signify whether the file to save DGT errors has 

been opened or not. If not opened, the DGT TSK 
program opens a new data file. ugt.tsk 

an INTEGERM output variable containing the number 
of errors generated by the DGT. r 

an INTEGERM input variable containing the current 
record number of the DGT error data file. rrent 

an INTEGER* 4 output variable used to return the 
execution status of the subroutine. th 

a CHARACTER *80 output variable containing the 
response of the DGT to the 'STAT' command 


NAME 3 


NUMERR 

RECN 3 

STATUS 

TEST 
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SUBROUTINE DGTCOMFILEl DBUG, FILEN. W* file. Commands 
are d !eq^?ia?l5 real fro. the file and transmitted to the 
DGT . 

SUBROUTINE DGTERR ( DBUG , °AV3 , NAME3 »^ CN records * the errors 
Sends the RERRLOG command to the DGT, ana 

generated by the DGT. 

68000 microprocessor. 

SUBROUTINE SAVERR(DBUG , NUMERR, GBUFF , DAY 3 , NAME3 , RECN3 , 

Records the JSS'ESSV the DGT when the RERRLOG 
oommand is executed. 


Programs : 


Experiment Control and 

Ml : CTRLLET . FTN / 1 1 1 
Ml : DSPLET . FTN / 1 1 1 


Monitor Software 


Check-Out Software 

Ml: DGT. FTN/ 111 
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History 
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mx ; U5PLIB1 . FTN/lll 

Richard C. Reinhart / Analex Corporation 
written December 1990 


Variables used by the subroutines: 


ADDR 


sn INTEGER* 4 input 
instrument address. 


variable containing the 


CHANNEL 


an INTEGER*4 input variable 
desired channel for the Wavetek 
command. 


representing the 
Peak Power Meter 


Valid inputs for the CHANNEL variable are 

1 Channel A 

2 Channel B 

3 Channel A and B 


DBUG 


IBUS 


^n. INTEGER* 4 input variable once used to output 
debug statements during the software development. 
This variable is not used within the subroutine and 
a value of zero is appropriate. 


an INTEGER* 4 
interface bus 


input variable containing the IEEE 488 
number. 


a CHARACTER* 5 input variable containing the name of 
the function sending a message to a particular 


ISTAT 

KBUS 


an INTEGER*4 output variable used to 
execution status of the subroutine. 


return the 


see IBUS 


LENGTH 


“ £NTEGER*4 input variable containing the number 
of bytes contained in the message string to send to 
an instrument. 


MSG 


OPTION 


an INTEGER*4 input/output array used as a message 
buffer containing the ASCII command sent to an 
instrument or device. Also contains the instrument 
response when one is transmitted. 

an * N . TEGER * 4 input variable specifying the 
condition of the Service Request Query. Valid 
inputs for the OPTION variable are: 

0 Disable SRQ 

1 Enable SRQ 
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STATUS see ISTAT 


STATUS 1 
STBIT 


see STATUS 

an INTEGER*4 output variable containing the error 

code^returned b y P t h e WaveteK Peak Power Heter if 

an prror is present. Consult the Wavetex user & 
manual for a detailed description of the error 

codes . 


SUBROUTINE ALLREMOTE (DBUG . STA ™ S1 ) partlcular sequence 

i;r o e ^e ln B S oVe“ e ^i% f \ n h % d jnH^atrSelk°!r.r r e 

defined for 1 the Experiment ^log ical 6 units' are^pened to the 
respective devices. 

^roTall^ower 0 Lelers^def fned in a particular sequence 

SUBROUTINE HPZERO (DBUG, IBUS.ADDR.STATOS, ISTAT) 

the°sensor^ be/o« Attempt ingto^ zero 0 the^powe^meterf 

Meter . 

SA Beacon Receiver. 

TSsThe™ Meter . Returns 

the appropriate error code if an error exists. 
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SUBROUTINE SRQPOLL (ADDR, I BUS , DBUG, OPTION, STATUS) 

Enables and Disables the service request poll of the Wavetek 
Peak Power Meter. The SRQ is used by the instrument to flag 
error conditions. 

SUBROUTINE DSPSEND ( ADDR , LENGTH , DBUG , KBUS , STATUS , MSG , ID) 
Transmits/receives ASCII messages to/from instruments on the 
IEEE 488 interface bus. This subroutine will read the 
output parameter from an instrument when the ID variable is 
properly specified. 


Programs : 


Experiment Control and Monitor Software 
Ml : CTRLLET . FTN /111 
Ml : DSPLET . FTN /111 
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Library Name M1:DSPLIB2.FTN/111 

Author Richard C. Reinhart / Analex Corporation 

History Written December 1990 


Variables used by the subroutines: 

ADDR an INTEGER* 4 input variable containing the 

instrument address. 

DBUG an INTEGER* 4 input variable once used to output 

debug statements during the software development. 
This variable is not used within the subroutine and 
a value of zero is appropriate. 

IBUS an INTEGER*4 input variable containing the IEEE 488 

interface bus number. 

ISLOT an INTEGER*4 input variable containing the slot 

number of the instrument in the instrument file 
array. 

NSTAT an INTEGER*4 output array indicating which of the 
initialization parameters are in error. 

OPTION an INTEGER*4 input variable indicating the desired 
channel for the Wavetek Peak Power Meter command. 

SETTINGS an INTEGER* 4 input array containing the HP Relay 
Actuator switch positions. 

Valid inputs for the SETTINGS variable are: 

0 Off 

1 On 

STATUS 1 an INTEGER*4 output variable used to return the 
execution status of the subroutine. 

STBIT an INTEGER*4 output variable containing the error 
code returned by the Wavetek Peak Power Meter , if 
an error is present. Consult the Wavetek User's 
manual for a detailed description of the error 
codes. 


SUBROUTINE ALLINIT (DBUG, STATUS1) 

Calls the appropriate subroutines to initialize all the 
instruments defined for a particular experiment. 
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SUBROUTINE CHECKERR ( ADDR , DBUG , IBUS, STATUS 1) 

Checks the status of the HP 437B Power Meter. 


BROUTINE CWINIT (DBUG, IBUS, ADDR, STATUS1, ISLOT, OPTION, STBIT) 
Initializes the CW mode of the Wavetek Peak Power Meter. 

in 1 f lude frequency, number of averages, offset and 
. s, T .^ e channel to receive the command is also specified 
using this subroutine. c 


SUBROUTINE DGDCINIT (DBUG, ISLOT, STATUS) 

Determines the state of the DGT, and if necessary enables 
Zk . m ° d * in b .urst rate. The DGT control is included in 

the DG/DC initialization routine because the initial modem 
r J f^ e ls contained in the Data Generator slot within 
the Instrument File. This routine will initialize the burst 
rate of the DGT if not properly configured* 

SUBROUTINE DGTINIT (DBUG , ISLOT, STATUS) 

So^TfT^m the DGT to detei f mines its present state. Similar to 
P G £ CINIT ; e ^cept that it does not change the state of the 
DGT. This is a read only command. 


SUBROUTINE FCINIT (ADDR, DBUG , IBUS, ISLOT, STATUS 1) 

Initializes the EIP Frequency Counter. Parameters include 
frequency band, resolution, frequency offset, frequency high 
limit, and frequency low limit. 


SUBROUTINE HPINIT (DBUG , IBUS, ADDR, ISLOT, STATUS) 

Initializes the HP 437B Power Meter. Parameters include 
frequency, range, trigger mode, offset, calibration factor, 
units, low limit, and high limit. 

SUBROUTINE PEAKINIT (DBUG, IBUS, ADDR, STATUS1, ISLOT, OPTION STBIT) 
Initializes the PEAK mode of the Wavetek Peak Power Meter. 
Parameters include frequency, number of averages, offset 
reference delay, cursor delay, and units. The channel to 
receive the command is also specified using this subroutine. 

SUBROUTINE PININIT(DBUG, IBUS, ADDR, ISLOT, STATUS1) 

I nitia 1 izes the HP 6632A Power Supply. Parameters include 
setting voltage, current, and high voltage. 

SUBROUTINE RAINIT (ADDR, IBUS, DBUG, STATUS, SETTINGS) 

Initializes the HP Relay Actuator. Each switch is 
initialized to either the on or off position. 
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SUBROUTINE SAINIT (DBUG, IBUS, ADDR, ISLOT, STATUS, NSTAT) 

Initializes the SA Beacon Receiver. Parameters incluci 
freauencv 2nd IF slot, gain control, gain hold, AGC time 
constant^ demod slot, 2nd LO mode select, 

AGC, anti-sideband select, and search mode selection. 

SUBROUTINE SWDRINIT (DBUG, IBUS ,ADDR, I SLOT , STATUS) j 

Initializes the HP Attenuator Switch Drivers when used 
solely as a switch driver. Switch positions are determined 
from individual locations within the instrument array. 


Programs : 


Experiment Control and Monitor Software 
Ml : CTRLLET . FTN /111 
Ml : DSPLET . FTN /111 
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Library Name 

Author 

History 

Variables used 
DBUG 

FLAG 

INS_SLOT 

OF 

• OUT_OF_ 
LIMIT 

POSITION 

SDA_FILE 

STATUS 1 
TDF_FILE 

VIEW 


Ml : DSPLIB3 . FTN /111 

Richard C. Reinhart / Analex Corporation 
Written December 1990 


by the subroutines: 

an INTEGER* 4 input variable once used to output 
debug statements during the software development. 
This variable is not used within the subroutine and 
a value of zero is appropriate. 

a CHARACTER* 3 output variable containing a mnemonic 
string indicating the out of limit condition, that 
is displayed to the user terminal during data 
acquisition. 

an INTEGER*4 input variable containing the 
instrument file array position of the instrument 
being tested. Instrument slot number indicates 
which bit position to test for an under or over 
limit condition. 

an INTEGER* 4 variable that specifies the desired 
output field number to be updated with data 
contained in 'OFDATA'. 

a LOGICAL output variable indicating if an out of 
limit condition exist. 

an INTEGER* 4 output array indicating which data 
array variable is out of limit. 

a CHARACTER* 20 input variable containing the name 
of the sequence definition file to be output to 
either the user terminal or to the line printer. 

an INTEGER*4 output variable used to return the 
execution status of the subroutine. 

a CHARACTER* 2 0 input variable containing the name 
of the instrument definition file to be output to 
either the user terminal or to the line printer. 

a CHARACTER* 1 input variable indicating the device 
to output the instrument definition and sequence 
definition files. 
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SUBROUTINE ALLLOCAL (DBUG, STATUS 1) 

Places all instruments defined for a particular sequence 
into local mode, returning control of the instrument to its 
front panel keys. 

SUBROUTINE BITDECODE ( INS_SLOT , FLAG , OF , OUT_OF_LIMIT , POSITION ) 
Determines if a saved reading is out of the user specified 
limits by testing the BUF2 variable. Out of limit 
conditions include: 

Under Limit Under Range 

Over Limit Over Range 

The out of limit condition is determined by the position of 
the bit set in the variable BUF2, listed in Table D-8. 
Status bits are stored in BUF2 beginning with bit number 
128, or BUF2 ( 6) . Bit positions are determined by the data 
field location and the instrument position within the 
Instrument File. This is illustrated in Table D-8 as an 
array with each bit position corresponding to an instrument 
and either its first or second data field. 


Out of limit 
condition 

Data field 

Instrument I 

Jumbei 

• 

j 



1 

2 

3 

4 

5 

m 

50 1 

under limit 

Data(l,*) 

128 

136 

144 

152 

• • • 



over limit 

Data (l , *) 

129 

137 

145 

• • • 




under range 

Data(l,*) 

130 

138 

146 





over range 

Data ( 1 , * ) 

131 

139 

147 





under limit 

Data (2,*) 

132 

140 

148 





over limit 

Data (2 , *) 

133 

141 

149 





1 under range 

Data (2,*) 

134 

142 

150 





| over range 

Data (2 , *) 

135 

143 

151 






Table D-8 Out of Limit Status Bit Positions 
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SUBROUTINE DISPLAY (VIEW, SDA_FILE , TDF_FILE) 

Outputs both the Instrument Definition and Sequence 
Definition files to either the line printer or to the user 
terminal. This subroutine was mainly used during the 
software development, and is not used for program execution. 


Programs : 

Experiment Control and Monitor Software 
Ml : DSPLET . FTN/ 111 
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Library Name M1:EBNZER0.FTN/111 

Richard C. Reinhart / Analex Corporation 
History Written December 1990 


Variables used by the subroutines: 

D_EBN0 a REAL*4 input variable containing the value of 
Eb/No desired by the user. 

SEQ_COL an INTEGERM input variable containing the sequence 
command number executed by the Sequence Execution 
Software. 


STATUS 


an INTEGERM output variable used to return the 
execution status of the subroutine. 


SUBROUTINE EBNZERO (SEQ_C0L, D_COL, STATUS) 

Sets the noise attenuator located within the IF Noise Unit 
to provide an Eb/No within +/- .55 dB of the user specified 
value. The routine will take measurements from the power 
meter specified in the Data Generator slot of the instrument 
fiie. This routine will not affect the signal attenuator. 
An initial noise attenuation value is read from the 
instrument file to begin the Eb/No calculation. Future 
calculations are made from the last value of attenuation 
used . 

The software was modified at ACTS System test to allow an 
external signal input to the independent experimenter uplink 
P or ^ surpress the noise floor during noise power 
measurements. 


Programs : 


Experiment Control and Monitor Software 
Ml : CTRLLET . FTN/ 111 
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Library Name 

Author 

History 


Ml : ENCDATA . FTN /111 
Richard C. Reinhart 
Written March 1991 


/ Analex Corporation 


Variables used by the subroutines: 


IN 

IRATE 


Table D-9 


a CHARACTER* 2 4 output array containing the input 
fields of the current menu. 

an INTEGER* 4 input variable specifying the user 
data rate listed in Table D-9. 


Data Rate 
Mbps 

IRATE 

ITYPE 

1.25 

0 

0 

5.00 

3 

0 

12.500 

5 

0 

13.824 

5 

8 

25.000 

8 

0 

27 . 648(88) 

8 

8 

27 . 648 (09) 

9 

0 

27.648(89) 

9 

8 

50.000 

12 

0 

55.296 

12 

8 

100.000 

13 

0 

110.592 

13 

8 

200.000 

15 

0 

221.184 

15 

8 
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ITYPE 


an INTEGER* 4 input variable soecifvinrt 
type listed in Table D- 9 . P Clfyin 9 the 


data 


8 


ssrs.ss.^-sraa 


SUBROUTINE TYPERATE( IRATE, ITYPE IN) 

ITYP^variables. ln?Ut d3ta rate into the Proper IRATE and 

• t th 

input data rate parameter. lables into the proper menu 


Programs : 


Experiment Control and Monitor Software 
M1:SDALET.FTN/111 are 
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Library Name 

Author 

History 


Ml : EXECLET. FTN/lll 

Richard C. Reinhart / Analex Corporation 
Written December 1990 


Variables used by the subroutines: 


COMM 

DBUG 


an INTEGER*4 input variable containing the current 
sequence command number . 


an INTEGER*4 input variable once used to output 
debug statements during the software development. 
The variable is not used within the subroutine and 
a value of zero is appropriate. 


GCOMM see COMM 

SEQ_NUM see COMM 

status 1 an INTEGER* 4 output variable used to return the 

STATUS 1 “^ tion status £ f the subroutine or the status of 

the system . 

VALUE a REAL* 4 input variable containing the output value 

of the instrument specified in the cnecx a 
Parameter command. 


IDUM see DBUG 

ICOMM see COMM 

ISTAT see STATUS 1 

ISTATUS see STATUS1 


SUBROUTINE CKLIMIT (VALUE, ICOMM, ISTAT) . - i the 

Compares the output value of the instrument s P ec ified in th 
Check a Parameter command to the user defined high and low 
limits to determine the appropriate control action. There 

are three possible paths. 

1) Output value greater than high value. 

2) Output value lower than low value. 

3) Output value within the specified range. 

Sequence control is transferred to the PJ°P e f dd itiSnSl 
accordingly. Refer to the EC&M User's Guide for additional 

information on control transfer. 
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Executed ™ CL < DBUG ' SEQ_NUM, STATUS 1 ) 

cSSSr specif saauence 1 " 6 *» °«ry out each 
performed before eacS colan^is lxecuted “"“^tlon 1. 
occur are transferred to the difr,?^ * d ‘ Any errors that 
FORTRAN VII rtl subroutine P * Y p ro 9 raro via the SNDMSG 


^ Obtains^* ( C °MM , STATUS1) 

instrument antTpasses it^t^the* CKLMi?^ 1116 appropriate 
specified for this CKLIMIT subroutine. Limits 

Instrument Definition Softwarl. lndependent of those in the 

SU TrTn^i NE PARMG0T0 (GCOMM, I STATUS) 

to the lequlnct ” Verona corre^ldino* G0T0 COMland 

specified by the user. Tn erro, ^ label nun,ber 

number matches the label spaced S2"2S5, “ ' M 

STOROUTINB PARMSET(DBUG, COMM, ISTATUS) 

parameter eC vflue U^Mmpared \o S t^^i"^ Va i ue ’ The new 

aj-nwas 

Potential out of limit f ls ° f peclfled in the IDS? 

routine and the user notified? In “if® det6cted b y this 
reported to the user reaardi *»<=«= f .. tirst occurrences are 
Future occurrences arl df£ 5 °£ the out of Unit action 
action selected by the user^ 6 ^ UP ° n the ° ut of li*it 


Parameters include: 

Attenuation 

Power Supply Voltage 

Frequency 

Wavetek Parameters 


Eb/No 


Power Supply Current 
Toggle Switch 

SA Beacon Receiver Parameters 
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SUBROUTINE PARMSTEP (DBUG, COMM, I STATUS) 

Increments or decrements (user defined) a specified 
parameter by a user defined amount. The new parameter value 
is compared to the high and low limits specified in the IDS 
and appropriate action taken depending on the out of limit 
condition also specified in the IDS. Potential out of limit 
errors are also detected by this routine and the user 
notified. All first occurrences are reported to the user 
regardless of the out of limit action. Future occurrences 
are dependent upon the out of limit action selected by the 
user. 

Parameters include: 

Attenuation Eb/No 

Power Supply Voltage Power Supply Current 

SUBROUTINE PERFBER (DBUG, COMM, STATUS 1) 

Uses subroutine DATALET to obtain BER measurements from the 
data checker. This routine uses the number of readings and 
time between each reading as specified by the user to take 
the proper BER measurements. Control flags are used to 
instruct DATALET to obtain the BER readings along with its 
normal data acquisition. A final data acquisition (without 
a BER measurement) is performed so that all BER readings are 
displayed to the user terminal. 


Programs : 


Experiment Control and Monitor Software 
Ml : CTRLLET . FTN/ 111 
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Library Name Ml : GENERLIB. FTN /111 

Author Elaine Daugherty / NASA Digital Technology Branch 

History Revised July, 1990 Version 1.0 <RCR> 

Variables used by the subroutines: 

ADDRESS an INTEGER*4 input variable containing the address 
of the instrument . 

DBUG an INTEGER*4 input variable once used to output 

debug statements during the software development. 
The variable is not used within the subroutine and 
a value of zero is appropriate. 

FN a CHARACTER*20 input variable containing the file 

name of the menu used by the menu driver. 

IDEV a CHARACTER*5 input variable representing the I/O 

device for the menu display. This variable is no 
longer used by the subroutine. 

IBUS an INTEGER*4 input variable containing the IEEE 488 

interface bus number. 

OFDATA a CHARACTER* 80 input variable containing the output 
field for the current menu. 

P a CHARACTER* 2 4 input variable containing the input 

fields for the current menu. 

STATUS an INTEGER*4 output variable used to return the 
execution status of the subroutine. 


SUBROUTINE CLEARM (IDEV, FN, P, OFDATA) 

Clears the input and output variables for the current menu. 

SUBROUTINE I CLEAR (DBUG , IBUS , STATUS) 

Clears the IEEE 488 interface bus. 

SUBROUTINE LOCAL (DBUG, IBUS , ADDRESS , STATUS) 

Returns control of an instrument to the front panel keys. 

SUBROUTINE REMOTE (DBUG , IBUS , ADDRESS , STATUS) 

Places an instrument under computer control. 
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Programs : 


Experiment Control and Monitor Software 

Ml : TDFLET . FTN/ 111 
Ml : SDALET . FTN/ 111 


Check-Out Software 


Ml: ALL. FTN/ 111 
M1:B37.FTN/111 
Ml : BER. FTN/ 111 
Ml : C9 . FTN/ 111 
Ml : C26 . FTN/ 111 
Ml : C27 . FTN/ 111 
Ml : L6 . FTN/ 111 
Ml : L16. FTN/111 
Ml : MAINCTRL . FTN/ 111 
Ml :N6. FTN/111 
Ml:N12. FTN/111 
Ml:N20. FTN/111 


Ml: PIN. FTN/111 
Ml :PM1. FTN/111 
Ml : PM2 . FTN/111 
Ml :R9 . FTN/111 
M1:R11. FTN/111 
Ml :R12. FTN/111 
Ml :RFU. FTN/111 
Ml : SA1 . FTN/111 
M1:U13. FTN/111 
Ml :U16. FTN/111 
Ml:U21. FTN/111 


LET-EC&M Software Maintenance Manual - Version 1.0 


89 



Appendix D - BC&H Software Libraries 


Library Name Ml:GMLIB.FTN/lll 

Author Richard C. Reinhart / Analex Corporation 

History Written October 2, 1990 Version 1.0 <RCR> 


Variables used by the subroutines: 

ADDRESS an INTEGER* 4 input variable containing the decimal 
address of the attenuator. 


ADDRS 

ATTN 

BUFF2 

BUFF3 

CHANN 


IN 

OFON 


see ADDRESS. 

a REAL* 4 input variable containing the desired 


value of attenuation, 
increments) 

0 < 

ATTN 

< 60.0 

(.05 

an INTEGER* 4 output 

array 

that 

contains 

the 


response from the attenuator if the echo is enabled 
or if an error occurs. 

see BUFF2 . 

a CHARACTER*! input variable containing the 
attenuator channel. 

1 Channel A 

2 Channel B 

a CHARACTER* 2 4 input array containing the input 
fields for the current menu. 

an INTEGER* 4 input variable that determines whether 
to turn the echo off or on. 

0 Off 

1 On 


PORT an INTEGER*4 input variable containing the logical 

unit assigned to the attenuator. 

STATUS an INTEGER* 4 output variable used to return the 
execution status of the subroutine. 


SUBROUTINE ECH0F0N (OFON , ADDRESS , PORT , STATUS , BUFF3 ) 

Enables or disables the echo feature on the GM attenuator 
controller board. 
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SUBROUTINE GMASET (ATTN , CHANN , ADDRS , PORT, STATUS , BUFF2 ) 

Custom initializes the GM attenuator with the ECHO DISABLED. 
The value of attenuation, attenuator address and channel are 
user specified. 

SUBROUTINE GMCHECK (ATTN, IN, STATUS) 

Verifies that the value of attenuation input by the user is 
within the valid range. 


Programs : 


Experiment Control and Monitor Software 
Ml : CTRLLET . FTN/ 111 
Ml : DSPLET . FTN /111 


Check-Out Software 
Ml: GAO. FTN/ 111 
Ml : GA1 . FTN /111 
Ml : GBO . FTN /111 
Ml : GB 1 . FTN /111 
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Library Name M1:GRTL15.0BJ/S 

Author BGL Technology Corporation 

History Copyright 1980 


Variables used by the subroutines are: 

ADDRESS an INTEGERM input variable containing the decimal 
address of the device. 

GRETC an INTEGER* 4 output variable used to return the 
execution status of the subroutine. 

LENGTH an INTEGER*4 input variable containing a decimal 
value indicating the number of characters contained 
in the MESSAGE string. 

MESSAGE an INTEGER* 4 input/ output array used as a message 
buffer containing command characters to be sent to 
a device or as a buffer to receive the response 
from the device. 


UTERMC an INTEGER*4 input variable containing the 
hexadecimal code for the message termination 
character used by the device. 


SUBROUTINE GCLOSE (GRETC) 

Closes the IEEE bus interface when all messages between the 
computer and bus devices have been sent. A GRETC value of 
zero indicates successful closing of the interface. 

SUBROUTINE GCTRL (MESSAGE, LENGTH, GRETC) 

Sends bus control messages to the bus controller. For this 
subroutine MESSAGE contains the hexadecimal command 
characters to be sent to the bus controller. A GRETC value 
of zero indicates successful execution of the subroutine. 

SUBROUTINE GINIT (GRETC) 

Initializes the IEEE 488 Interface. 

NOTE: This Subroutine MUST be called first. For this 

subroutine GRETC must be set to zero before calling 
the subroutine. A GRETC value of zero indicates 
successful initialization of the interface. 

SUBROUTINE GLSTNB (ADDRESS, MESSAGE, LENGTH, GRETC) 

Receives a binary string from a device on the bus. For this 
subroutine MESSAGE is a buffer into which a response from a 
device on the bus is stored. For this subroutine LENGTH is 
the number of characters read from the device. 
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SUBROUTINE GTALKA (ADDRESS .MESSAGE^ LENGTH , G^RETC^ . FO r this 

‘SSSLSTSZJSF'i the Routine. 

SUBROUTINE GLSTNA (ADDRESS ^MESSAGE^LENGTljWUTE^C^GRETG) 

same as GLSTNB except that an ASCI character must be 

suppUe^^tn^tL^UTESc^variable. GLSTNB worKs for most 
instruments and is more generic 

SUBROUTINE GTALKB “nkry N ste ing'Ts ««* t0 . the 

GT No L S K t devices" expect an Jscil string, therefore 
rvr&T,KA is preferred. 


Programs : 


Experiment Control and Monitor 
Ml : DSPLET . FTN /111 


Software 


Check-Out Software 

Ml: ALL. FTN/ 111 
Ml : B37 . FTN/ 111 

MliBER.FTN/lll 

M1:C9 .FTN/111 

Ml : C2 6 . FTN /111 

M1-.C27.FTN/1H 

M1-.L6.FTN/1H 

Ml:L16.FTN/lH 

Ml : MAINCTRL . FTN /111 

Ml:N6. FTN/111 

Ml:N12. FTN/111 


M1:N20. FTN/111 
Ml: PIN. FTN/ 111 
M1:PM1.FTN/1H 
Ml:PM2.FTN/lll 

Ml :R9. FTN/111 
M1-.RH.FTN/111 

Ml : R12 • FTN/111 
Ml: SA1. FTN/111 
M1-.U13. FTN/111 
M1:U16. FTN/111 
Ml:U21. FTN/111 
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Library Name 

Author 

History 


Ml : INSETUP . FTN /111 

Richard C. Reinhart / Analex Corporation 
Written December 1990 


Variables used by the subroutines: 


DATA 


a CHARACTER * 80 
of data that 
file. 


input variable containing one record 
is read from the DEFAULT . LET dafa 


DEFAULT2 


a REAL *4 two-dimensional 
the instrument default 
DEFAULT. LET file. 


output array containing 
values read from the 


START 
STATUS 2 
VALUE 


ISsuIon* ^'f'tirdatrrecord "to^e/od"/. ““ Starting 
execu ti^ E ^tatus t of Subroutine'! t0 return the 

d%ooferLoStre%aSa r ^rd. C ° ntainin9 the 


S R B e°dS I in Jh SE a UP . < DEFAU LT2,STATUS2) 

Reads m the default valuer nf +kL ■ ^ 

from an external ASCII file T J?' n lnstr ument parameters 
file is Ml: DEFAULT. LET/ 111 * Usertt « ® ^ 4 _ the ASCI1 data 

DEFAULT. LET to modifv' i-h* - U t ma y edit the data file 

values. DEFAULT. LET Y is uLd* in conT* parameter default 

file Ml: LABELS. LET/ ill to LdnoS ° n ^ nctlon with a second 
restrictions withinthe DEFaJltSt of fo ™at 

LABELS. LET, is maintain^ Kt, Ik flle * The se cond file 
contains a list of the instrument- 6 J^ r .°^ rain developer and 
used in the DEFAULT. LET data f .. and 11 \ struinen t parameters 
this manual for additi^af^nformatio^ 6 " t0 Se ° tion 5 ° f 

Sl DeS 1 6 DECREC (START, DATA, VALUE) 

Decodes each record ^ , , 

data file. A minimum of one^paceVT th ® DEFA ULT.LET 
between the parameter naiJ comma must exist 
record. P rameter name and parameter value in each 


Programs : 


Monitor So(tware 
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Library Name 

Author 

History 


Ml : MENUP . FTN / 2 

Ml : MENUP2 . FTN /111 , , _ 

Monty Andro / NASA Digital Technology Branch 

Revised 1987 Ed Petrik / NASA DTB 


Variables used by the subroutines: 

longer used by the subroutine. 

p a CHARACTER* 2 4 input array which contains the input 

field reads. 

OF an INTEGER*4 input variable which d ata 

desired output field number to be updated with data 

contained in ' OFDATA' 

OFDATA ZSSfrZZ 

passed in 'OF'. 

CMN ° "ri~;i r ei nP ana 

settings . 

TM r ppr'FR*4 inout variable which contains a menu 
number to be displayed or input field number 
defining input options. 

FKEY an INTEGER* 4 input/output variable which contains 

FKE the function key number activated during a read. 

a CHARACTER* 2 0 input variable containing the file 
name of the menu used by the menu driver. 

STAT an INTEGER *4 output variable which returns the 

efafne of the subroutine. 


consult the MENUP documentation. 
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Note: 


tha t d MPmiP^ nC n b ® tween library MENUP and MENUP2 is 
that MENUP 2 perforins a write with a wait while* 

MENUP perforins a write and continue. The write and 
or continue refers to the £un!t?Sn 

l " the SYSIO when writing menus to the user 

iSSTi?!! 1 *- _ Refer . to the OS/32 User's Manual for 
addition information on the SYSIO subroutine. 


Programs : 


Experiment Control and Monitor Software 
Ml : SDALET . FTN /111 
Ml : TDFLET . FTN/ 111 


Check-Out Software 
Ml : ALL . FTN /111 
Ml : B37 . FTN/ 111 
Ml : BER . FTN /111 
Ml: BIT. FTN/ 111 
Ml : C9 . FTN /111 
Ml : C2 6 . FTN /111 
Ml : C2 7 . FTN /111 
Ml: DAI. FTN/ 111 
Ml .‘DAT. FTN/ 111 
Ml: GAO. FTN/ 111 
Ml : GA1 . FTN /111 
Ml : GBO . FTN/ 111 
Ml :GB1. FTN/111 
Ml : L6 . FTN /111 
Ml:L16.FTN/lll 


Ml : MAINCTRL . FTN /111 
Ml : N6 . FTN/ 111 
Ml : N12 . FTN/ 111 
Ml :N20. FTN/ 111 
Ml: PIN. FTN/ 111 
Ml :PM1. FTN/111 
Ml : PM2 . FTN/ 111 
Ml : R9 . FTN/ 111 
M1:R11.FTN/111 
Ml :R12. FTN/111 
M1:RFU.FTN/111 
Ml : SA1 . FTN/ 111 
Ml : U13 . FTN/111 
Ml :U16. FTN/111 
Ml : U21 . FTN/111 
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Library Name Ml : SA1SEC. FTN/lll 

Author Richard C. Reinhart / Analex Corporation 

History Written December 1990 


Variables used by the subroutines: 

ADDR an INTEGERM input variable containing the 

instrument address. 

COUNT an INTEGER* 4 output variable whose value indicates 
the Master Division Alarm bit in error. 

COUNT 1 see COUNT 

IBUS an INTEGER*4 input variable containing the IEEE 

interface bus number. 

SLOPE an INTEGER* 4 output variable containing the slope 
value read from the SA Beacon Receiver. 

STATUS an INTEGER*4 output variable used to return the 

execution status of the subroutine. 

TEST a INTEGER*4 input array containing the Master 

Division Alarm Status bits returned from the SA 
Beacon Receiver. 


SUBROUTINE RSLOPE (IBUS, ADDR, SLOPE, STATUS) 

Reads the SIG STR SLOPE setting of the SA Beacon Receiver. 
Values range from 10.00 to 40.00 db/Volt. 
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SUBROUTINE SASTAT ( IBUS , ADDR, STATUS , COUNT) 

Reads the status of the MASTER DIVISION ALARMS of the SA 
Beacon Receiver. The alarm bit settings are user defined. 
Settings in place at time of this publication are listed in 
Table D-10. 


Bit 

Number 

Correct 

Value 

Description 

0 

0 

No hardware fault 
present in Tuner 
lock alarm 

1 

0 

Demod slot 1 locked 

2 

1 

Demod slot 2 not 
locked 

3 

0 

Carrier above 
threshold 

4 

0 

No hardware fault 
present in 
Frequency 
Synthesizer 

5 

1 

Internal reference 

6 

0 

No hardware fault 
present in 2nd LO 
Lock Alarm 

7 

1 

Internal LO 


Table D-10 Master Division Alarm Status Codes 


SUBROUTINE SA1ERRCK ( IBUS , STATUS , TEST , COUNT1 ) 

Compares the MASTER DIVISION ALARM status returned from the 
SA Beacon Receiver with the user defined configuration and 
returns the appropriate status to the SASTAT subroutine. 


Programs : 


Experiment Control and Monitor Software 
Ml : CTRLLET . FTN/ 111 
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Ml : SDALIB2 . FTN/ 111 

Richard C. Reinhart / Analex Corporation 
Written December 1990 Version 1.0 


Variables used by the subroutines: 

COL an INTEGER* 4 input variable that contains the 

current sequence number. 


SUBROUTINE PMZERO (COL) 

Defines an instrument to zero. Valid instruments include the 
Wavetek Peak Power Meters, HP Power Meters, or the SA Beacon 
Receiver. 

SUBROUTINE SETPARM (COL) 

Defines the parameter to set, parameter value and 
instrument. Valid parameters to set are; frequency, 
attenuation, Eb/No, power supply voltage, power supply 
current, toggle switch, selected Wavetek parameters, and 
selected SA Beacon Receiver parameters. 

SUBROUTINE STARTDG (COL) 

Sets up a command to start the Data Generator. User data 
type , user data rate, modem rate and data destination are 
required. Internal flags (Continuous, Bursted) are set for 
DGT control. 

SUBROUTINE STEPPARM (COL) 

Defines the parameter to step, parameter increment or 
decrement value, and instrument. Valid parameters to step 
are; attenuation, power supply voltage, power supply current 
and Eb/No. 

SUBROUTINE STOPDC (COL) 

Sets up command to stop the Data Checker . Default is Data 
Checker number 1. 

SUBROUTINE STOPDG (COL) 

Sets up command to stop the Data Generator. Default is Data 
Generator number 1 . 
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SUBROUTINE WAITT (COL) 

Defines the length of time to suspend sequence execution. 
Total time and interval time must both be entered. Interval 
time controls how many readings are taken within the total 
wait time. Bypass data acquisition by selecting the 
appropriate menu option. 


Programs : 


Experiment Control and Monitor Software 
Ml : SDALET . FTN /111 
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Library Name 

Author 

History 


Ml : SDALIB3 . FTN/111 

Richard C. Reinhart / Analex Corporation 
Written December 1990 Version 1.0 


Variables used by the subroutines: 


COL 
COL2 
LAB ELI N 

LABELOUT 

LAST_LABEL 

MENU 


an INTEGER* 4 input variable that contains the 
current sequence number. 

an INTEGER*4 input variable that contains the 
current sequence number. 

an INTEGER*4 input variable containing a user 
input label number for the sequence number 
COL2 . 

an INTEGER* 4 output variable containing the 
sequence control label number generated by the 
LABELIT subroutine. 

an INTEGER*4 input variable that contains the 
label number last input by the user before 
entering the SETLOOP subroutine. 

an INTEGER* 4 input variable that contains the 
menu number of the current menu for the 
purpose of displaying error messages to the 
user terminal. 


SUBROUTINE BERMEASURE (COL, MENU) 

Defines a bit error rate measurement. Required parameters 
are time from starting the Data Generator until reading the 
Data Checker, the number of measurements at a particular 
Eb/No, and the data destination. Data Generator number one 
is automatically selected. Define both a Data Generator and 
a Data Checker in the IDS or errors will result. 

SUBROUTINE CALLSUB (COL) 

Defines the name of a sub-s'equence within a main sequence. 
A Sub-sequence file must exist before it is called. Nested 
Sub-sequences are not supported. 
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SUBROUTINE CHECKPARM (COL) 

Defines the parameter to check, the parameter high and low 
limits, and the respective label numbers to goto in the 
event the parameter is outside the defined limits. 
Parameters to check include power level, Eb/No, bit error 
rate, power supply voltage, power supply current and 
frequency counter reading. 

SUBROUTINE GOTOST (COL) 

Transfers control during a sequence to a command other than 
the succeeding command. Label numbers are converted to 
sequence control numbers only if the label currently exists. 
If a label does not yet exist, it is converted to a control 
number by the ENDSEQ subroutine in program SDALET . 

SUBROUTINE LABELIT (LABELIN , LABELOUT , C0L2 , STATUS 1) 

Converts a user input label number to a sequence control 
label number. Sequence control label numbers can be a 
single execution label number, loop label number or sub- 
sequence label number. Label numbers are converted to 
sequence control numbers only if the label currently exists. 
If a label does not yet exist, it is converted to a control 
number by the ENDSEQ subroutine in program SDALET. 

SUBROUTINE SETERROR (COL) 

Defines the number of errors to include in user data. Data 
Generator number one is assumed, no other input required. 

SUBROUTINE SETLOOP (COL, LAST_LABEL) 

Defines a loop within a sequence. The number of commands 
within the loop is calculated by the subroutine. Nested 
loops are not supported. The label number of the final 
sequence command 'END SEQUENCE' is reserved for software 
control . 


Programs : 


Experiment Control and Monitor Software 
Ml : SDALET . FTN/ 111 
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